en to uk translation catalogue (2813 entries)

note: Tag: title
en: PostGIS Administration
uk: Адміністрування PostGIS

note: Tag: title
en: Configuring raster support
uk: Налаштування підтримки растрів

note: Tag: para
en: If you enabled raster support you may want to read below how to properly configure it.
uk: Якщо ви увімкнули підтримку растрів, ви можете прочитати нижче, як правильно її налаштувати.

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"/>.
uk: Починаючи з версії 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:
uk: Якщо ви хочете увімкнути офлайн-растр:

note: Tag: para
en: Any other setting or no setting at all will disable out of db rasters.
uk: Будь-який інший параметр або відсутність параметра взагалі вимкне растри з db.

note: Tag: para
en: In order to enable all GDAL drivers available in your GDAL install, set this environment variable as follows
uk: Щоб увімкнути всі драйвери GDAL, доступні у вашому встановленні GDAL, встановіть цю змінну оточення наступним чином

note: Tag: para
en: If you want to only enable specific drivers, set your environment variable as follows:
uk: Якщо ви хочете увімкнути лише певні драйвери, налаштуйте змінну оточення наступним чином:

note: Tag: para
en: If you are on windows, do not quote the driver list
uk: Якщо ви використовуєте 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.
uk: Налаштування змінних оточення залежить від операційної системи. Для PostgreSQL, встановленого на Ubuntu або Debian за допомогою apt-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.
uk: У 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.
uk: Після того, як ви встановите змінні оточення, вам потрібно буде перезапустити службу PostgreSQL, щоб зміни набули чинності.

note: Tag: title
en: Creating spatial databases
uk: Створення просторових баз даних

note: Tag: title
en: Spatially enable database using EXTENSION
uk: Активувати просторове розширення в базі данних за допомогою EXTENSION

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.
uk: Якщо ви використовуєте PostgreSQL 9.1+ і скомпілювали та встановили модулі extensions/postgis, ви можете перетворити базу даних на просторову за допомогою механізму EXTENSION.

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.
uk: Основне розширення PostGIS включає геометрію, географію, spatial_ref_sys та всі функції і коментарі. Растр і топологія упаковані як окреме розширення.

note: Tag: para
en: Run the following SQL snippet in the database you want to enable spatially:
uk: Виконайте наступний фрагмент SQL-коду в базі даних, яку ви хочете активувати просторове розширення:

note: Tag: title
en: Spatially enable database without using EXTENSION (discouraged)
uk: Активувати просторове розширення бази даних без використання EXTENSION (не рекомендується)

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).
uk: Зазвичай це потрібно лише в тому випадку, якщо ви не можете або не хочете встановлювати PostGIS у каталозі розширень PostgreSQL (наприклад, під час тестування, розробки або в обмеженому середовищі).

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.
uk: Додавання об'єктів PostGIS та визначень функцій до вашої бази даних здійснюється шляхом завантаження різних файлів sql, розташованих у <filename>[prefix]/share/contrib</filename>, як зазначено під час фази побудови.

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.
uk: Основні об'єкти 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.
uk: Для отримання повного набору ідентифікаторів визначення системи координат EPSG ви також можете завантажити файл визначень <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.
uk: Якщо ви бажаєте додати коментарі до функцій PostGIS, ви можете знайти їх у скрипті <filename>postgis_comments.sql</filename>. Коментарі можна переглянути, просто ввівши <command>\dd [function_name]</command> у вікні терміналу <command>psql</command>.

note: Tag: para
en: Run the following Shell commands in your terminal:
uk: Виконайте наступні команди Shell у терміналі:

note: Tag: title
en: Upgrading spatial databases
uk: Оновлення просторових баз даних

note: Tag: para
en: Upgrading existing spatial databases can be tricky as it requires replacement or introduction of new PostGIS object definitions.
uk: Оновлення існуючих просторових баз даних може бути складним, оскільки вимагає заміни або впровадження нових визначень об'єктів 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.
uk: На жаль, не всі визначення можна легко замінити в активній базі даних, тому іноді найкращим варіантом є процес дампа/перезавантаження.

note: Tag: para
en: PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and a HARD UPGRADE procedure for major releases.
uk: PostGIS надає процедуру SOFT UPGRADE для незначних випусків або випусків з виправленням помилок, а також процедуру HARD UPGRADE для основних випусків.

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.
uk: Перед тим, як спробувати оновити PostGIS, завжди варто зробити резервну копію ваших даних. Якщо ви використовуєте прапор -Fc для pg_dump, ви завжди зможете відновити дамп за допомогою HARD UPGRADE.

note: Tag: title
en: Soft upgrade
uk: М'яке оновлення

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.
uk: Якщо ви встановили базу даних за допомогою розширень, вам також потрібно буде оновити її за допомогою моделі розширень. Якщо ви встановили базу даних за допомогою старого скрипту sql, рекомендуємо перейти на розширення, оскільки скрипт більше не підтримується.

note: Tag: title
en: Soft Upgrade 9.1+ using extensions
uk: М'яке оновлення 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.
uk: Якщо ви спочатку встановили 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.
uk: Якщо ви використовуєте PostGIS 3 або вище, то вам слід скористатися функцією <xref linkend="PostGIS_Extensions_Upgrade"/>, щоб оновити систему до останньої версії, яку ви встановили.

note: Tag: para
en: If you are running PostGIS 2.5 or lower, then do the following:
uk: Якщо ви використовуєте 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:
uk: Якщо у вас встановлено кілька версій PostGIS і ви не хочете оновлювати їх до останньої версії, ви можете явно вказати версію наступним чином:

note: Tag: para
en: If you get an error notice something like:
uk: Якщо ви отримаєте повідомлення про помилку, схоже на таке:

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.
uk: Потім вам потрібно буде створити резервну копію вашої бази даних, створити нову, як описано в <xref linkend="create_new_db_extensions"/>, а потім відновити резервну копію на цій новій базі даних.

note: Tag: para
en: If you get a notice message like:
uk: Якщо ви отримаєте таке повідомлення:

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:
uk: Тоді все вже оновлено і ви можете сміливо ігнорувати це. <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.
uk: Якщо ви спочатку встановили PostGIS без вказання версії, то часто можна пропустити перевстановлення розширення postgis перед відновленням, оскільки резервна копія містить лише <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:
uk: Якщо ви оновлюєте розширення PostGIS з версії до 3.0.0, у вас з’явиться нове розширення <emphasis>postgis_raster</emphasis>, яке можна безпечно видалити, якщо вам не потрібна підтримка растрових даних. Видалити його можна так:

note: Tag: title
en: Soft Upgrade Pre 9.1+ or without extensions
uk: М'яке оновлення до версії 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:
uk: Цей розділ стосується лише тих, хто встановив 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>.
uk: ПРИМІТКА: якщо ви переходите з PostGIS 1.* на PostGIS 2.* або з PostGIS 2.* до версії r7409, ви не можете використовувати цю процедуру, а повинні виконати <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:
uk: Після компіляції та встановлення (make install) ви повинні знайти набір файлів <filename>*_upgrade.sql</filename> в папках інсталяції. Ви можете перелічити їх усі за допомогою:

note: Tag: para
en: Load them all in turn, starting from <filename>postgis_upgrade.sql</filename>.
uk: Завантажте їх по черзі, починаючи з <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:
uk: Така сама процедура застосовується до розширень raster, topology та 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
uk: Рекомендується перейти на інсталяцію на основі розширення, виконавши команду

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>.
uk: Якщо ви не можете знайти файл <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.
uk: Функція <xref linkend="PostGIS_Full_Version"/> повинна повідомити вас про необхідність виконання такого оновлення за допомогою повідомлення "procs need upgrade" (процедури потребують оновлення).

note: Tag: title
en: Hard upgrade
uk: Жорстке оновлення

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.
uk: Під HARD UPGRADE ми маємо на увазі повне скидання/перезавантаження баз даних з підтримкою PostGIS. HARD UPGRADE необхідний, коли змінюється внутрішнє зберігання об'єктів PostGIS або коли SOFT UPGRADE неможливий. У додатку <link linkend="release_notes">Release Notes</link> для кожної версії вказано, чи потрібно для оновлення виконувати скидання/перезавантаження (HARD UPGRADE).

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.
uk: Процес вивантаження/перезавантаження здійснюється за допомогою скрипта 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>.
uk: Додаткові інструкції для користувачів Windows доступні за посиланням <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade">Windows Hard upgrade</link>.

note: Tag: para
en: The Procedure is as follows:
uk: Процедура виглядає наступним чином:

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.
uk: Створіть дамп бази даних, яку ви хочете оновити, у "власному форматі" (назвемо його <varname>olddb</varname>), включіть бінарні блоки (-b) та детальний вивід (-v). Користувач може бути власником бази даних, не обов'язково мати супер-акаунт postgres.

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.
uk: Виконайте нову інсталяцію 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.
uk: Записи spatial_ref_sys, знайдені у вашому дампі, будуть відновлені, але вони не замінять існуючі записи в spatial_ref_sys. Це зроблено для того, щоб виправлення в офіційному наборі були правильно передані до відновлених баз даних. Якщо з якоїсь причини ви дійсно хочете замінити стандартні записи своїми власними, просто не завантажуйте файл spatial_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>.
uk: Якщо ваша база даних дуже стара або ви знаєте, що використовуєте давно застарілі функції у своїх представлень та функціях, можливо, вам доведеться завантажити <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.
uk: Відновіть резервну копію у новій базі даних <varname>newdb</varname> за допомогою postgis_restore. Несподівані помилки, якщо такі будуть, будуть виведені psql у стандартний потік помилок. Зберігайте їх у журналі.

note: Tag: para
en: Errors may arise in the following cases:
uk: Помилки можуть виникати в таких випадках:

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>.
uk: Деякі з ваших представлень або функцій використовують застарілі об'єкти 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 ).
uk: Деякі користувацькі записи spatial_ref_sys у файлі дампа мають недійсне значення SRID. Дійсні значення SRID більші за 0 і менші за 999000. Значення в діапазоні 999000.999999 зарезервовані для внутрішнього використання, а значення > 999999 не можуть використовуватися взагалі. Усі ваші користувацькі записи з недійсними 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:
uk: Щоб виправити цю ситуацію, слід скопіювати власний SRS до SRID із дійсним значенням (можливо, в діапазоні 910000..910999), перетворити всі таблиці на новий 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 :
uk: Якщо ви оновлюєте стару базу даних, що містить французьку <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 :
uk: У цьому випадку ви можете спробувати виконати наступні кроки: спочатку повністю видаліть IGN із sql, що є результатом postgis_restore. Отже, після виконання:

note: Tag: para
en: run this command :
uk: виконайте цю команду:

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 :
uk: Створіть нову базу даних newdb, активуйте необхідні розширення Postgis і правильно вставте французьку систему IGN за допомогою: <link xlink:href="https://raw.githubusercontent.com/Remi-C/IGN_spatial_ref_for_PostGIS/master/Put_IGN_SRS_into_Postgis.sql"> цього скрипту </link> Після цих операцій імпортуйте свої дані:

note: Tag: title
en: Performance Tuning
uk: Налаштування продуктивності

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.
uk: Налаштування продуктивності PostGIS дуже схоже на налаштування будь-якого робочого навантаження PostgreSQL. Єдиним додатковим моментом, який слід врахувати, є те, що геометрії та растри зазвичай мають великий розмір, тому оптимізації, пов'язані з пам'яттю, зазвичай мають більший вплив на PostGIS, ніж на інші типи запитів PostgreSQL.

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.
uk: У PostgreSQL версії 9.4 і вище конфігурацію можна встановити на рівні сервера без редагування файлів <code>postgresql.conf</code> або <code>postgresql.auto.conf</code> за допомогою команди <code>ALTER SYSTEM</code>.

note: Tag: para
en: In addition to the Postgres settings, PostGIS has some custom settings which are listed in <xref linkend="PostGIS_GUC"/>.
uk: Окрім налаштувань Postgres, PostGIS має деякі власні налаштування, які перелічені в <xref linkend="PostGIS_GUC"/>.

note: Tag: title
en: Startup
uk: Запуск

note: Tag: para
en: These settings are configured in <code>postgresql.conf</code>:
uk: Ці налаштування конфігуруються в <code>postgresql.conf</code>:

note: Tag: para
en: Default: partition
uk: За замовчуванням: 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.
uk: Зазвичай використовується для розділення таблиць. За замовчуванням встановлено значення "partition", яке ідеально підходить для PostgreSQL 8.4 і вище, оскільки змушує планувальник аналізувати таблиці на предмет обмежень тільки в тому випадку, якщо вони знаходяться в успадкованій ієрархії, і не застосовувати штрафні санкції до планувальника в інших випадках.

note: Tag: para
en: Default: ~128MB in PostgreSQL 9.6
uk: За замовчуванням: ~128 МБ у PostgreSQL 9.6

note: Tag: para
en: Set to about 25% to 40% of available RAM. On windows you may not be able to set as high.
uk: Встановіть приблизно 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.
uk: <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
uk: За замовчуванням: 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.
uk: Встановлює максимальну кількість фонових процесів, які може підтримувати система. Цей параметр можна встановити тільки під час запуску сервера.

note: Tag: title
en: Runtime
uk: Час роботи

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
uk: <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
uk: За замовчуванням: 1-4 МБ

note: Tag: para
en: Adjust up for large dbs, complex queries, lots of RAM
uk: Налаштуйте для великих баз даних, складних запитів, великого обсягу оперативної пам'яті

note: Tag: para
en: Adjust down for many concurrent users or low RAM.
uk: Зменште налаштування для великої кількості одночасних користувачів або малої оперативної пам'яті.

note: Tag: para
en: If you have lots of RAM and few developers:
uk: Якщо у вас багато оперативної пам'яті і мало розробників:

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.
uk: <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
uk: За замовчуванням: 16-64 МБ

note: Tag: para
en: Generally too low - ties up I/O, locks objects while swapping memory
uk: Зазвичай занадто низький - блокує введення-виведення, блокує об'єкти під час обміну пам'яттю

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:
uk: Рекомендуємо від 32 МБ до 1 ГБ на виробничих серверах з великим об'ємом оперативної пам'яті, але це залежить від кількості одночасних користувачів. Якщо у вас багато оперативної пам'яті і мало розробників:

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.
uk: Це налаштування доступне лише у PostgreSQL версії 9.6 і вище та впливає лише на PostGIS 2.3 і новіші версії, оскільки тільки PostGIS 2.3 і вище підтримує паралельні запити. Якщо встановити значення більше за 0, деякі запити, наприклад ті, що використовують реляційні функції, як-от <code>ST_Intersects</code>, можуть виконуватись із використанням кількох процесів і працювати більш ніж удвічі швидше. Якщо у вас багато вільних процесорів, варто встановити це значення рівним кількості наявних процесорів. Також переконайтеся, що параметр <code>max_worker_processes</code> встановлений принаймні на таке саме значення.

note: Tag: para
en: Default: 0
uk: За замовчуванням: 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.
uk: Встановлює максимальну кількість воркерів, які може запустити один вузол <varname>Gather</varname>. Паралельні воркери беруться з пулу процесів, створеного параметром <varname>max_worker_processes</varname>. Зауважте, що запитувана кількість воркерів може бути недоступною під час виконання. Якщо це станеться, план виконання буде працювати з меншою кількістю воркерів, ніж очікувалося, що може призвести до неефективності. Встановлення цього значення в 0, що є значенням за замовчуванням, вимикає виконання паралельних запитів.

note: Tag: title
en: PostGIS Extras
uk: Додаткові функції 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.
uk: У цьому розділі описано функції, що містяться в папці extras архівів вихідного коду PostGIS та репозиторії вихідного коду. Вони не завжди входять до складу бінарних випусків PostGIS, але зазвичай є скриптами на основі PL/pgSQL або стандартними скриптами оболонки, які можна запускати без змін.

note: Tag: title
en: Address Standardizer
uk: Стандартизатор адрес

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.
uk: Стандартизатор адрес — це однорядковий аналізатор адрес, який приймає вхідну адресу та нормалізує її на основі набору правил, що зберігаються в таблиці та допоміжних таблицях lex і gaz.

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>
uk: Код упакований в одну бібліотеку розширення PostgreSQL під назвою <code>address_standardizer</code>, яке можна встановити за допомогою команди <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.
uk: Код цього розширення можна знайти в PostGIS <filename>extensions/address_standardizer</filename> і на даний момент він є самостійним.

note: Tag: para
en: For installation instructions refer to: <xref linkend="installing_pagc_address_standardizer"/>.
uk: Інструкції з установки див.: <xref linkend="installing_pagc_address_standardizer"/>.

note: Tag: title
en: How the Parser Works
uk: Як працює парсер

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.
uk: Парсер працює справа наліво, спочатку перевіряючи макроелементи для поштового індексу, штату/провінції, міста, а потім перевіряє мікроелементи, щоб визначити, чи маємо ми справу з номером будинку, вулицею, перехрестям або орієнтиром. Наразі він не перевіряє код країни або назву, але це може бути додано в майбутньому.

note: Tag: term
en: Country code
uk: Код країни

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
uk: Вважається, що місцезнаходження — США або Канада, на підставі: поштового індексу США або Канади, штату/провінції США або Канади, в іншому випадку — США

note: Tag: term
en: Postcode/zipcode
uk: Поштовий індекс

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.
uk: Вони розпізнаються за допомогою регулярних виразів, сумісних з Perl. Ці регулярні вирази наразі знаходяться у файлі parseaddress-api.c і їх відносно просто змінити, якщо це необхідно.

note: Tag: term
en: State/province
uk: Штат/провінція

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.
uk: Вони розпізнаються за допомогою регулярних виразів, сумісних з Perl. Ці регулярні вирази наразі знаходяться в parseaddress-api.c, але в майбутньому можуть бути переміщені в includes для полегшення обслуговування.

note: Tag: title
en: Address Standardizer Types
uk: Типи стандартизаторів адрес

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.
uk: У цьому розділі наведені типи даних PostgreSQL, встановлені розширенням Address Standardizer. Зверніть увагу, що ми описуємо поведінку приведення типів (casting), що є особливо важливим при розробці власних функцій.

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.
uk: Композитний тип, що складається з елементів адреси. Це тип повернення для функції <varname>standardize_address</varname>.

note: Tag: title
en: Description
uk: Опис

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>.
uk: Композитний тип, що складається з елементів адреси. Це тип повернення для функції <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"/>.
uk: Номери токенів позначають вихідний номер посилання в <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.
uk: є текстом (номер токена <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>.
uk: є текстом (номер токена <code>1</code>): Це номер будинку на вулиці. Приклад <emphasis>75</emphasis> в <code>75 State Street</code>.

note: Tag: para
en: is text (token number <code>2</code>): STREET NAME PRE-DIRECTIONAL such as North, South, East, West etc.
uk: є текстом (номер токена <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>.
uk: є текстом (номер токена <code>3</code>): ПРЕДМОДИФІКАТОР НАЗВИ ВУЛИЦІ Приклад <emphasis>OLD</emphasis> в <code>3715 OLD HIGHWAY 99</code>.

note: Tag: para
en: is text (token number <code>4</code>): STREET PREFIX TYPE
uk: є текстом (номер токена <code>4</code>): ПРЕФІКС ВУЛИЦІ ТИП

note: Tag: para
en: is text (token number <code>5</code>): STREET NAME
uk: є текстом (номер токена <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>.
uk: є текстом (номер токена <code>6</code>): ТИП ВУЛИЦІ, наприклад St, Ave, Cir. Тип вулиці, що йде після основної назви вулиці. Приклад <emphasis>STREET</emphasis> в <code>75 State Street</code>.

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>.
uk: є текстом (номер токена <code>7</code>): STREET POST-DIRECTIONAL Модифікатор напрямку, що стоїть після назви вулиці. Приклад <emphasis>WEST</emphasis> в <code>3715 TENTH AVENUE WEST</code>.

note: Tag: para
en: is text (token number <code>8</code>): RURAL ROUTE . Example <emphasis>7</emphasis> in <code>RR 7</code>.
uk: є текстом (номер токена <code>8</code>): СІЛЬСЬКИЙ МАРШРУТ . Приклад <emphasis>7</emphasis> в <code>RR 7</code>.

note: Tag: para
en: is text: Extra information like Floor number.
uk: є текстом: Додаткова інформація, така як номер поверху.

note: Tag: para
en: is text (token number <code>10</code>): Example Boston.
uk: є текстом (номер токена <code>10</code>): Приклад Бостон.

note: Tag: para
en: is text (token number <code>11</code>): Example <code>MASSACHUSETTS</code>
uk: є текстом (номер токена <code>11</code>): (Приклад <code>MASSACHUSETTS</code>

note: Tag: para
en: is text (token number <code>12</code>): Example <code>USA</code>
uk: є текстом (номер токена <code>12</code>): Приклад <code>США</code>

note: Tag: para
en: is text POSTAL CODE (ZIP CODE) (token number <code>13</code>): Example <code>02109</code>
uk: є текстом ПОШТОВИЙ ІНДЕКС (ЗІП-КОД) (номер токена <code>13</code>): Приклад <code>02109</code>

note: Tag: para
en: is text POSTAL BOX NUMBER (token number <code>14 and 15</code>): Example <code>02109</code>
uk: є текстом НОМЕР ПОШТОВОЇ СКРИНЬКИ (номер токена <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>.
uk: є текстом Номер квартири або номер люкса (номер токена <code>17</code>): Приклад <emphasis>3B</emphasis> в <code>APT 3B</code>.

note: Tag: title
en: Address Standardizer Tables
uk: Таблиці стандартизації адрес

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.
uk: У цьому розділі перелічено формати таблиць PostgreSQL, які використовує address_standardizer для нормалізації адрес. Зверніть увагу, що ці таблиці не обов'язково мають мати ті самі назви, що й зазначені тут. Наприклад, ви можете мати різні таблиці lex, gaz, rules для кожної країни або для вашого власного геокодера. Назви цих таблиць передаються у функції стандартизатора адрес.

note: Tag: para
en: The packaged extension <varname>address_standardizer_data_us</varname> contains data for standardizing US addresses.
uk: Розширення <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.
uk: Таблиця правил містить набір правил, які відображають токени вхідної послідовності адрес на стандартизовану вихідну послідовність. Правило визначається як набір вхідних токенів, за якими слідує -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.
uk: Таблиця правил повинна містити принаймні такі стовпці, хоча ви можете додавати інші для власних потреб.

note: Tag: para
en: Primary key of table
uk: Первинний ключ таблиці

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>.
uk: текстове поле, що позначає правило. Детальніше див. <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-rec--">Записи правил стандартизації адрес PAGC</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).
uk: Правило складається з набору невід'ємних цілих чисел, що представляють вхідні маркери, закінчується -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.
uk: Так, наприклад, правило <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"/>.
uk: Номери відповідних вихідних токенів наведені в <xref linkend="stdaddr"/>.

note: Tag: title
en: Input Tokens
uk: Вхідні токени

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:
uk: Кожне правило починається з набору вхідних токенів, за якими слідує роздільник <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
uk: Токени введення на основі форм

note: Tag: para
en: (13). The ampersand (&amp;) is frequently used to abbreviate the word "and".
uk: (13). Символ амперсанд (&amp;) часто використовується для скорочення слова "and".

note: Tag: para
en: (9). A punctuation character.
uk: (9). Розділовий знак.

note: Tag: para
en: (21). A sequence of two letters. Often used as identifiers.
uk: (21). Послідовність двох літер. Часто використовується як ідентифікатор.

note: Tag: para
en: (25). Fractions are sometimes used in civic numbers or unit numbers.
uk: (25). Дроби іноді використовуються в цивільних числах або числах одиниць.

note: Tag: para
en: (23). An alphanumeric string that contains both letters and digits. Used for identifiers.
uk: (23). Алфавітно-цифровий рядок, що містить як літери, так і цифри. Використовується для ідентифікаторів.

note: Tag: para
en: (0). A string of digits.
uk: (0). Ряд цифр.

note: Tag: para
en: (15). Representations such as First or 1st. Often used in street names.
uk: (15). Такі позначення, як "Перший" або "1-й". Часто використовуються в назвах вулиць.

note: Tag: para
en: (18). A single letter.
uk: (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.
uk: (1). Слово — це послідовність літер довільної довжини. Окрема літера може бути як SINGLE так і WORD.

note: Tag: emphasis
en: Function-based Input Tokens
uk: Функціональні вхідні токени

note: Tag: para
en: (14). Words used to denote post office boxes. For example <emphasis>Box</emphasis> or <emphasis>PO Box</emphasis>.
uk: (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>.
uk: (19). Слова, що використовуються для позначення будівель або будівельних комплексів, зазвичай як префікс. Наприклад: <emphasis>Вежа</emphasis> в <emphasis>Вежа 7A</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>.
uk: (24). Слова та абревіатури, що використовуються для позначення будівель або будівельних комплексів, зазвичай як суфікс. Наприклад: <emphasis>Торговий центр</emphasis>.

note: Tag: para
en: (22). Words used to denote directions, for example <emphasis>North</emphasis>.
uk: (22). Слова, що використовуються для позначення напрямків, наприклад <emphasis>Північ</emphasis>.

note: Tag: para
en: (20). Words used to denote milepost addresses.
uk: (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>
uk: (6). Слова та абревіатури, що використовуються для позначення автомагістралей та доріг. Наприклад: <emphasis>Interstate</emphasis> в <emphasis>Interstate 5</emphasis>

note: Tag: para
en: (8). Words and abbreviations used to denote rural routes. <emphasis>RR</emphasis>.
uk: (8). Слова та абревіатури, що використовуються для позначення приміських маршрутів. <emphasis>RR</emphasis>.

note: Tag: para
en: (2). Words and abbreviations used to denote street types. For example: <emphasis>ST</emphasis> or <emphasis>AVE</emphasis>.
uk: (2). Слова та абревіатури, що використовуються для позначення типів вулиць. Наприклад: <emphasis>ST</emphasis> або <emphasis>AVE</emphasis>.

note: Tag: para
en: (16). Words and abbreviations used to denote internal subaddresses. For example, <emphasis>APT</emphasis> or <emphasis>UNIT</emphasis>.
uk: (16). Слова та абревіатури, що використовуються для позначення внутрішніх підадрес. Наприклад, <emphasis>APT</emphasis> або <emphasis>UNIT</emphasis>.

note: Tag: emphasis
en: Postal Type Input Tokens
uk: Токени введення поштового типу

note: Tag: para
en: (28). A 5 digit number. Identifies a Zip Code
uk: (28). 5-значний номер. Ідентифікує поштовий індекс

note: Tag: para
en: (29). A 4 digit number. Identifies ZIP4.
uk: (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.
uk: (27). Послідовність з 3 символів, що складається з літери, цифри та літери. Ідентифікує FSA, перші 3 символи канадського поштового індексу.

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.
uk: (26). Послідовність з 3 символів, що складається з цифри, літери та цифри. Ідентифікує LDU, останні 3 символи канадського поштового індексу.

note: Tag: emphasis
en: Stopwords
uk: Стоп-слова

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.
uk: СТОПСЛОВА поєднуються зі СЛОВАМИ. У правилах послідовність декількох СЛІВ і СТОПСЛІВ буде представлена одним токеном СЛОВА.

note: Tag: para
en: (7). A word with low lexical significance, that can be omitted in parsing. For example: <emphasis>THE</emphasis>.
uk: (7). Слово з низьким лексичним значенням, яке можна опустити при розборі. Наприклад: <emphasis>THE</emphasis>.

note: Tag: title
en: Output Tokens
uk: Вихідні токени

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"/>.
uk: Після першого -1 (роздільника) йдуть вихідні маркери та їх порядок, а потім термінатор <code>-1</code>. Номери відповідних вихідних маркерів наведені в <xref linkend="stdaddr"/>. Допустимі значення залежать від типу правила. Вихідні маркери, допустимі для кожного типу правила, наведені в <xref linkend="rule_types_rank"/>.

note: Tag: title
en: Rule Types and Rank
uk: Типи правил та їхній ранг

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).
uk: Остання частина правила - це тип правила, який позначається одним із наступних символів, за яким слідує рангове значення правила. Правила ранжуються від 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>
uk: (номер токена = "<emphasis role="bold">0</emphasis>"). Клас правил для розбору MACRO класів, таких як <emphasis>PLACE STATE ZIP</emphasis>

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>.
uk: <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"
uk: (токен номер "10"). Приклад "Albany"

note: Tag: para
en: (token number "11"). Example "NY"
uk: (токен номер "11"). Приклад "NY"

note: Tag: para
en: (token number "12"). This attribute is not used in most reference files. Example "USA"
uk: (токен номер "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.
uk: (токен номер "13"). (Елементи SADS "ZIP CODE" , "PLUS 4" ). Цей атрибут використовується як для поштових індексів США, так і для поштових індексів Канади.

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.
uk: (номер токена = "<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>.
uk: <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.
uk: (номер маркера = "<emphasis role="bold">2</emphasis>"). Клас правил для розбору клаузул MICRO, за винятком атрибуту HOUSE. Як такий, використовує той самий набір вихідних маркерів, що й MICRO_C, за винятком маркера HOUSE.

note: Tag: para
en: (token number = "<emphasis role="bold">3</emphasis>"). The class of rules for parsing the HOUSE attribute.
uk: (номер токена = "<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.
uk: (номер токена = "<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>.
uk: <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.
uk: (токен номер <code>0</code>): Нерозпізнані ідентифікатори та типи будівель.

note: Tag: para
en: (token number <code>14</code>): The <emphasis role="bold">BOX</emphasis> in <code>BOX 3B</code>
uk: (токен номер <code>14</code>): <emphasis role="bold">БОКС</emphasis> в <code>БОКС 3B</code>

note: Tag: para
en: (token number <code>15</code>): The <emphasis role="bold">3B</emphasis> in <code>BOX 3B</code>
uk: (токен номер <code>15</code>): <emphasis role="bold">3B</emphasis> в <code>BOX 3B</code>

note: Tag: para
en: (token number <code>8</code>): The <emphasis role="bold">RR</emphasis> in <code>RR 7</code>
uk: (токен номер <code>8</code>): <emphasis role="bold">RR</emphasis> в <code>RR 7</code>

note: Tag: para
en: (token number <code>16</code>): The <emphasis role="bold">APT</emphasis> in <code>APT 3B</code>
uk: (токен номер <code>16</code>): <emphasis role="bold">APT</emphasis> в <code>APT 3B</code>

note: Tag: para
en: (token number <code>17</code>): The <emphasis role="bold">3B</emphasis> in <code>APT 3B</code>
uk: (токен номер <code>17</code>): <emphasis role="bold">3B</emphasis> в <code>APT 3B</code>

note: Tag: para
en: (token number <code>9</code>): An otherwise unclassified output.
uk: (токен номер <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.
uk: Таблиця lex використовується для класифікації алфавітно-цифрового вводу та пов'язування цього вводу з (а) вхідними токенами (див. <xref linkend="rule_input_tokens"/>) та (б) стандартизованими представленнями.

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>.
uk: Таблиця lex (скорочення від lexicon) використовується для класифікації алфавітно-цифрового вводу та пов'язування цього вводу з <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
uk: Lex має принаймні такі стовпці в таблиці. Ви можете додати

note: Tag: para
en: text: the input word
uk: text: вхідне слово

note: Tag: para
en: text: the standardized replacement word
uk: text: вхідне слово стандартизоване слово-замінник

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>.
uk: integer: тип слова. Замінюється тільки в цьому контексті. Див. <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--i-tok--">Токени PAGC</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.
uk: Таблиця gaz використовується для стандартизації географічних назв та пов'язування цих даних з (а) вхідними токенами (див. <xref linkend="rule_input_tokens"/>) та (б) стандартизованими представленнями.

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.
uk: Таблиця gaz (скорочення від gazeteer) використовується для стандартизації назв місць та пов'язування цих даних з <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.
uk: Таблиця gaz має принаймні такі стовпці. Ви можете додати більше стовпців, якщо це необхідно для ваших потреб.

note: Tag: para
en: integer: definition number? - identifier used for that instance of the word
uk: integer: definition number? - ідентифікатор, що використовується для цього екземпляра слова

note: Tag: title
en: Address Standardizer Functions
uk: Функції стандартизації адреси

note: Tag: refpurpose
en: Returns a json formatted text listing the parse tokens and standardizations
uk: Повертає текст у форматі 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.
uk: Це функція для налагодження правил стандартизації адрес та відповідності лексичних одиниць (lex/gaz). Вона повертає текст у форматі json, що містить правила відповідності, відображення токенів та найкращу стандартизовану адресу <xref linkend="stdaddr"/> у вигляді вхідної адреси з використанням <xref linkend="lextab"/>імен таблиць, <xref linkend="gaztab"/>та <xref linkend="rulestab"/>імен таблиць та адреси.

note: Tag: para
en: For single line addresses use just <varname>micro</varname>
uk: Для однорядкових адрес використовуйте лише <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>.
uk: Для дворядкової адреси A <varname>micro</varname>, що складається зі стандартного першого рядка поштової адреси, наприклад <code>house_num street</code>, та макросу, що складається зі стандартного другого рядка поштової адреси, наприклад <code>city, state postal_code country</code>.

note: Tag: para
en: Elements returned in the json document are
uk: Елементи, що повертаються в документі 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.
uk: Для кожного слова у вхідній адресі повертає позицію слова, категоризацію лексеми слова та стандартне слово, до якого воно відноситься. Зверніть увагу, що для деяких вхідних слів ви можете отримати кілька записів, оскільки деякі вхідні дані можуть бути віднесені до декількох категорій.

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
uk: Набір правил, що відповідають вхідним даним, та відповідний бал для кожного з них. Перше правило (з найвищим балом) використовується для стандартизації

note: Tag: para
en: The standardized address elements <xref linkend="stdaddr"/> that would be returned when running <xref linkend="standardize_address"/>
uk: Стандартизовані елементи адреси <xref linkend="stdaddr"/>, які будуть повернуті при виконанні <xref linkend="standardize_address"/>

note: Tag: para
en: Availability: 3.4.0
uk: Доступність: 3.4.0

note: Tag: title
en: Examples
uk: Приклади

note: Tag: para
en: Using address_standardizer_data_us extension
uk: Використання розширення address_standardizer_data_us

note: Tag: para
en: Variant 1: Single line address and returning the input tokens
uk: Варіант 1: Адреса в одному рядку та повернення вхідних токенів

note: Tag: para
en: Variant 2: Multi line address and returning first rule input mappings and score
uk: Варіант 2: Багаторядкова адреса та повернення перших правил введення та оцінок

note: Tag: title
en: See Also
uk: Див. також

note: Tag: refpurpose
en: Takes a 1 line address and breaks into parts
uk: Бере 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>.
uk: Повертає адресу як вхідні дані та повертає запис, що складається з полів <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: Availability: 2.2.0
uk: Доступність: 2.2.0

note: Tag: para
en: Single Address
uk: Одинарна адреса

note: Tag: para
en: Table of addresses
uk: Таблиця адрес

note: Tag: refpurpose
en: Returns an stdaddr form of an input address utilizing lex, gaz, and rule tables.
uk: Повертає форму stdaddr вхідної адреси, використовуючи таблиці lex, gaz та rule.

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.
uk: Повертає <xref linkend="stdaddr"/>форму вхідної адреси, використовуючи <xref linkend="lextab"/>ім'я таблиці, <xref linkend="gaztab"/>та <xref linkend="rulestab"/>імена таблиць та адресу.

note: Tag: para
en: Variant 1: Takes an address as a single line.
uk: Варіант 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>.
uk: Варіант 2: Приймає адресу у вигляді 2 частин. A <varname>micro</varname>, що складається зі стандартного першого рядка поштової адреси, наприклад <code>house_num street</code>, та макросу, що складається зі стандартного другого рядка поштової адреси, наприклад <code>city, state postal_code country</code>.

note: Tag: para
en: Variant 1: Single line address. This doesn't work well with non-US addresses
uk: Варіант 1: Адреса в одному рядку. Це не працює з адресами за межами США

note: Tag: para
en: Using tables packaged with tiger geocoder. This example only works if you installed <varname>postgis_tiger_geocoder</varname>.
uk: Використання таблиць, що входять до складу геокодера 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
uk: Щоб полегшити читання, ми будемо виводити дані за допомогою розширення hstore CREATE EXTENSION hstore; вам потрібно встановити

note: Tag: para
en: Variant 2: As a two part Address
uk: Варіант 2: Як адреса, що складається з двох частин

note: Tag: title
en: History Tracking
uk: Відстеження історії

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?
uk: Припустимо, ви маєте таблицю даних, яка відображає поточний стан певного географічного об'єкта. Таблиця ділянок, таблиця доріг, таблиця фруктових дерев тощо. Зазвичай інструменти ГІС сприймають таблицю як єдиний об'єкт, в якому можна оновлювати, вставляти та видаляти рядки. Як дозволити звичайним інструментам ГІС працювати з вашими даними, зберігаючи при цьому журнал змін, які були внесені, хто їх вніс та який був попередній стан даних?

note: Tag: para
en: This <varname>history_table</varname> extra module provides some utility functions for creating and maintaining history.
uk: Цей додатковий модуль <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.
uk: <varname>history_table</varname> також було включено до PostGIS 1.5, але додано до документації в PostGIS 2.0. Цей пакет написано мовою plpgsql і розміщено в <varname>extras/history_table</varname> архівів вихідного коду PostGIS та репозиторію вихідного коду.

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:
uk: Якщо у вас є таблиця "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.
uk: Коли ви вставляєте новий запис у "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.
uk: Коли ви видаляєте запис у "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.
uk: Коли ви оновлюєте запис у "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:
uk: Зберігаючи цю інформацію, можна отримати історію будь-якого запису в таблиці roads:

note: Tag: para
en: Or, to retrieve a view of the roads table at any point in the past:
uk: Або, щоб отримати перегляд таблиці доріг в будь-який момент в минулому:

note: Tag: refpurpose
en: Creates a table that will hold some interesting values for managing history tables.
uk: Створює таблицю, яка буде містити деякі цікаві значення для управління таблицями історії.

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>
uk: Створює таблицю, яка буде містити деякі цікаві значення для управління таблицями історії. Створює таблицю з назвою <varname>historic_information</varname>

note: Tag: para
en: Availability: 1.5.0
uk: Доступність: 1.5.0

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.
uk: Реєструє таблицю в таблиці history_information для відстеження, а також додає в side line history таблицю та правила вставки, оновлення та видалення в таблиці.

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.
uk: Реєструє таблицю в таблиці history_information для відстеження, а також додає в side line history таблицю з тим самим іменем, що й таблиця, але з префіксом <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.
uk: Ця функція наразі залежить від того, чи зареєстровано стовпець геометрії в <varname>geometry_columns</varname>, і не працює, якщо стовпець геометрії відсутній у таблиці <varname>geometry_columns</varname>.

note: Tag: title
en: Tiger Geocoder
uk: Геокодер Tiger

note: Tag: para
en: A plpgsql based geocoder written to work with the <link xlink:href="https://www2.census.gov/geo/tiger/">TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export</link> released by the US Census Bureau.
uk: Геокодер на основі plpgsql, написаний для роботи з <link xlink:href="https://www2.census.gov/geo/tiger/">TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export</link>, випущеним Бюро перепису населення США.

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.
uk: Геокодер складається з чотирьох компонентів: функції завантаження даних, нормалізатор адрес, геокодер адрес та зворотний геокодер.

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.
uk: Хоча ця програма розроблена спеціально для США, багато її концепцій та функцій можна застосувати та адаптувати до адресних та дорожніх мереж інших країн.

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.
uk: Скрипт створює схему під назвою <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>.
uk: Також створюється інша схема під назвою <varname>tiger_data</varname>, яка містить усі дані перепису населення для кожного штату, які завантажувач завантажує з веб-сайту Census і завантажує в базу даних. У поточній моделі кожен набір таблиць штатів має префікс з кодом штату, наприклад <varname>ma_addr</varname>, <varname>ma_edges</varname> тощо, з обмеженнями, що застосовуються лише до даних цього штату. Кожна з цих таблиць успадковує таблиці <varname>addr</varname>, <varname>faces</varname>, <varname>edges</varname> тощо, розташовані в схемі <varname>tiger schema</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.
uk: Усі функції геокодування посилаються лише на базові таблиці, тому немає вимоги, щоб схема даних називалася <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"/>.
uk: Інструкції щодо увімкнення розширення у вашій базі даних, а також завантаження даних за його допомогою, див. <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"/>
uk: Якщо ви використовуєте геокодер tiger (tiger_2010), ви можете оновити скрипти за допомогою супровідних скриптів upgrade_geocoder.bat / .sh у папці extras/tiger. Одне з основних змін між <varname>tiger_2010</varname> та <varname>tiger_2011+</varname> полягає в тому, що таблиці <varname>county</varname> та <varname>state</varname> більше не розділені за штатами. Якщо у вас є дані з 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.
uk: Нововведенням у версії 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.
uk: Новою функцією у версії PostGIS 2.1.0 є можливість інсталяції геокодера tiger із розширенням PostgreSQL, якщо ви використовуєте PostgreSQL 9.1+. Детальнішу інформацію див. у <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.
uk: Функція <xref linkend="Pagc_Normalize_Address"/>замінює вбудовану функцію <xref linkend="Normalize_Address"/>. Інструкції щодо компіляції та встановлення див. у <xref linkend="installing_pagc_address_standardizer"/>.

note: Tag: para
en: Design:
uk: Дизайн:

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.
uk: Метою цього проекту є створення повністю функціонального геокодера, який може обробляти довільний рядок адреси в США і, використовуючи нормалізовані дані перепису 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.
uk: Функція <varname>reverse_geocode</varname>, введена в PostGIS 2.0.0, корисна для отримання адреси вулиці та перехресних вулиць з 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.
uk: Геокодер повинен бути простим для встановлення та використання будь-яким користувачем, знайомим з PostGIS, а також легко встановлюватися та працювати на всіх платформах, що підтримуються PostGIS.

note: Tag: para
en: It should be robust enough to function properly despite formatting and spelling errors.
uk: Він повинен бути достатньо надійним, щоб працювати належним чином, незважаючи на помилки форматування та орфографії.

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.
uk: Він повинен бути достатньо розширюваним, щоб його можна було використовувати з майбутніми оновленнями даних або альтернативними джерелами даних з мінімальними змінами в коді.

note: Tag: para
en: The <varname>tiger</varname> schema must be added to the database search path for the functions to work properly.
uk: Щоб функції працювали належним чином, схема <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
uk: Існує ще кілька відкритих геокодерів для PostGIS, які, на відміну від tiger geocoder, мають перевагу у вигляді підтримки геокодування для різних країн

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.
uk: <link xlink:href="http://wiki.openstreetmap.org/wiki/Nominatim">Nominatim</link> використовує дані у форматі OpenStreetMap gazeteer. Для завантаження даних необхідні osm2pgsql, PostgreSQL 8.4+ та PostGIS 1.5+. Програма упакована як веб-інтерфейс і, судячи з усього, призначена для виклику як веб-сервіс. Так само, як і геокодер tiger, він має компоненти геокодера та зворотного геокодера. З документації не зрозуміло, чи має він чистий інтерфейс SQL, як геокодер tiger, чи значна частина логіки реалізована у веб-інтерфейсі.

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.
uk: <link xlink:href="http://www.gisgraphy.com/">GIS Graphy</link> також використовує PostGIS і, як і Nominatim, працює з даними OpenStreetMap (OSM). Він постачається з завантажувачем для завантаження даних OSM і, подібно до Nominatim, здатний геокодувати не тільки США. Подібно до Nominatim, він працює як веб-сервіс і використовує Java 1.5, додатки Servlet, 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>
uk: <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>
uk: <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.
uk: Це корисно для мінімізації роздуття індексу, яке може заплутати планувальник запитів або зайняти зайвий простір. Використовуйте разом з <xref linkend="Install_Missing_Indexes"/>, щоб додати тільки індекси, які використовуються геокодером.

note: Tag: para
en: Availability: 2.0.0
uk: Доступність: 2.0.0

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>.
uk: Створює скрипт, який видаляє всі таблиці у вказаній схемі, що починаються з <varname>county_all</varname>, <varname>state_all</varname> або коду штату, за яким слідує <varname>county</varname> або <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.
uk: Створює скрипт, який видаляє всі таблиці у вказаній схемі, що починаються з <varname>county_all</varname>, <varname>state_all</varname> або коду штату, за яким слідує <varname>county</varname> або <varname>state</varname>. Це потрібно, якщо ви оновлюєте дані з <varname>tiger_2010</varname> до <varname>tiger_2011</varname>.

note: Tag: para
en: Availability: 2.1.0
uk: Доступність: 2.1.0

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.
uk: Створює скрипт, який видаляє всі таблиці у вказаній схемі, що мають префікс у вигляді абревіатури стану. Якщо схема не вказана, за замовчуванням використовується схема <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.
uk: Створює скрипт, який видаляє всі таблиці у вказаній схемі, що мають префікс з абревіатурою стану. Якщо схема не вказана, за замовчуванням використовується схема <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)
uk: Приймає адресу у вигляді рядка (або іншої нормалізованої адреси) і виводить набір можливих місць, що включають геометрію точки в NAD 83 long lat, нормалізовану адресу для кожного з них та рейтинг. Чим нижчий рейтинг, тим більша ймовірність збігу. Результати сортуються за найнижчим рейтингом. Можна додатково передати максимальну кількість результатів (за замовчуванням 10) та обмежити регіон (за замовчуванням 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.
uk: Приймає адресу у вигляді рядка (або вже нормалізовану адресу) і виводить набір можливих місць, що включають геометрію точки в NAD 83 long lat, <varname>normalized_address</varname> (addy) для кожного з них та рейтинг. Чим нижчий рейтинг, тим більша ймовірність збігу. Результати сортуються за найнижчим рейтингом. Використовує дані Tiger (краї, грані, адреси), нечітке зіставлення рядків PostgreSQL (soundex, levenshtein) та функції інтерполяції ліній PostGIS для інтерполяції адреси вздовж країв Tiger. Чим вищий рейтинг, тим менша ймовірність правильності геокоду. Геокодована точка за замовчуванням зміщена на 10 метрів від центральної лінії в бік (L/R) від адреси вулиці, на якій вона розташована.

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.
uk: Покращено: 2.0.0 для підтримки структурованих даних Tiger 2010 та переглянуто деякі логічні алгоритми для підвищення швидкості, точності геокодування та зміщення точки від центральної лінії до сторони вулиці, на якій розташована адреса. Новий параметр <varname>max_results</varname> корисний для вказання кількості найкращих результатів або для повернення лише найкращого результату.

note: Tag: title
en: Examples: Basic
uk: Приклади: Базові

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.
uk: Наведені нижче приклади часу виконання були отримані на однопроцесорному комп'ютері з частотою 3,0 ГГц, операційною системою Windows 7, 2 ГБ оперативної пам'яті та встановленим програмним забезпеченням PostgreSQL 9.1rc1/PostGIS 2.0, завантаженим усіма даними про штати Массачусетс, Міннесота, Каліфорнія та Род-Айленд, отриманими з Tiger.

note: Tag: para
en: Exact matches are faster to compute (61ms)
uk: Точні збіги обчислюються швидше (61 мс)

note: Tag: para
en: Even if zip is not passed in the geocoder can guess (took about 122-150 ms)
uk: Навіть якщо zip-код не передається, геокодер може вгадати (займає близько 122-150 мс)

note: Tag: para
en: Can handle misspellings and provides more than one possible solution with ratings and takes longer (500ms).
uk: Може обробляти орфографічні помилки та надає кілька можливих рішень з оцінками, але працює довше (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).
uk: Використовується для пакетного геокодування адрес. Найпростіше встановити <varname>max_results=1</varname>. Обробляються тільки ті, що ще не геокодовані (не мають рейтингу).

note: Tag: title
en: Examples: Using Geometry filter
uk: Приклади: Використання фільтра "Geometry"

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).
uk: Приймає 2 перехресні вулиці, штат, місто, поштовий індекс і видає набір можливих місць на першій перехресній вулиці, що знаходиться на перехресті, а також включає геокоординати як точку розташування в NAD 83 long lat, <varname>normalized_address</varname> (адреса) для кожного місця та рейтинг. Чим нижчий рейтинг, тим більша ймовірність збігу. Результати сортуються за найнижчим рейтингом. Можна вказати максимальну кількість результатів, за замовчуванням — 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)
uk: Приймає 2 перехресні вулиці, штат, місто, поштовий індекс і виводить набір можливих місць на першій перехресній вулиці, що знаходиться на перехресті, а також включає геометрію точки в NAD 83 long lat, нормалізовану адресу для кожного місця та рейтинг. Чим нижчий рейтинг, тим більша ймовірність збігу. Результати сортуються за найнижчим рейтингом. Можна опціонально передати максимальну кількість результатів, за замовчуванням 10. Повертає <varname>normalized_address</varname> (addy) для кожного, geomout як точку розташування в NAD 83 long lat та рейтинг. Чим нижчий рейтинг, тим більша ймовірність збігу. Результати сортуються за найнижчим рейтингом. Використовує дані 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)
uk: Наведені нижче приклади часу виконання отримані на однопроцесорному комп'ютері з частотою 3,0 ГГц, ОС Windows 7, 2 ГБ оперативної пам'яті, PostgreSQL 9.0/PostGIS 1.5 та всіма даними про тигрів штату Массачусетс. Наразі трохи повільно (3000 мс)

note: Tag: para
en: Testing on Windows 2003 64-bit 8GB on PostGIS 2.0 PostgreSQL 64-bit Tiger 2011 data loaded -- (41ms)
uk: Тестування на Windows 2003 64-біт 8 ГБ на 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
uk: Навіть якщо zip не передається, геокодер може вгадати (на комп'ютері з Windows 7 це зайняло близько 3500 мс), на Windows 2003 64-біт — 741 мс

note: Tag: refpurpose
en: Returns value of specific setting stored in tiger.geocode_settings table.
uk: Повертає значення конкретного параметра, збереженого в таблиці 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:
uk: Повертає значення конкретного параметра, збереженого в таблиці 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.
uk: Змінено: 2.2.0: стандартні налаштування тепер зберігаються в таблиці під назвою geocode_settings_default. Налаштування, що були змінені користувачем, зберігаються в geocode_settings і містять лише ті налаштування, які були встановлені користувачем.

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.
uk: Повертає переписний район або поле з таблиці районів, де розташована геометрія. За замовчуванням повертається коротка назва району.

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.
uk: За заданою геометрією поверне місце розташування переписної ділянки цієї геометрії. Якщо просторова система координат не вказана, використовується NAD 83 (довгота, широта).

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.
uk: Ця функція використовує перепис <varname>tract</varname>, який за замовчуванням не завантажується. Якщо ви вже завантажили таблицю штатів, ви можете завантажити tract, а також bg і tabblock за допомогою скрипту <xref linkend="Loader_Generate_Census_Script"/>.

note: Tag: para
en: If you have not loaded your state data yet and want these additional tables loaded, do the following
uk: Якщо ви ще не завантажили дані про свій штат і хочете завантажити ці додаткові таблиці, виконайте наступні дії

note: Tag: para
en: then they will be included by the <xref linkend="Loader_Generate_Script"/>.
uk: тоді вони будуть включені за допомогою <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.
uk: Знаходить усі таблиці з ключовими стовпцями, що використовуються в з'єднаннях геокодера та умовах фільтрації, в яких відсутні використовувані індекси для цих стовпців, і додає їх.

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.
uk: Знаходить усі таблиці в схемах <varname>tiger</varname> та <varname>tiger_data</varname> із ключовими стовпцями, що використовуються в з'єднаннях та фільтрах геокодера, для яких відсутні індекси в цих стовпцях, і виводить SQL DDL для визначення індексу для цих таблиць, а потім виконує згенерований скрипт. Це допоміжна функція, яка додає нові індекси, необхідні для пришвидшення запитів, які могли бути відсутні під час процесу завантаження. Ця функція є доповненням до <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.
uk: Створює скрипт оболонки для вказаної платформи для вказаних штатів, який завантажить таблиці даних Tiger census state tract, bg та tabblocks, підготує та завантажить їх у схему <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.
uk: Створює скрипт оболонки для вказаної платформи для вказаних станів, який завантажить дані перепису Tiger <varname>tract</varname>, групи блоків <varname>bg</varname> та таблиці даних <varname>tabblocks</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.
uk: Для завантаження використовується програма unzip в Linux (7-zip в Windows за замовчуванням) та wget. Для завантаження даних використовується <xref linkend="shp2pgsql_usage"/>. Зверніть увагу, що найменша одиниця, яку обробляє програма, — це цілий штат. Програма обробляє лише файли в папках staging та temp.

note: Tag: para
en: It uses the following control tables to control the process and different OS shell syntax variations.
uk: Для управління процесом і різними варіантами синтаксису оболонки ОС використовуються наступні таблиці управління.

note: Tag: para
en: <varname>loader_variables</varname> keeps track of various variables such as census site, year, data and staging schemas
uk: <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.
uk: <varname>loader_platform</varname> профілі різних платформ і розташування різних виконуваних файлів. Поставляється з Windows і Linux. Можна додати інші.

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>
uk: <varname>loader_lookuptables</varname> кожен запис визначає тип таблиці (штат, округ), чи обробляти записи в ній і як їх завантажувати. Визначає кроки для імпорту даних, підготовки даних, додавання, видалення стовпців, індексів та обмежень для кожного з них. Кожна таблиця має префікс із зазначенням стану та успадковує таблицю зі схеми tiger. Наприклад, створюється <varname>tiger_data.ma_faces</varname>, яка успадковує <varname>tiger.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.
uk: включає цю логіку, але якщо ви встановили tiger geocoder до PostGIS 2.0.0 alpha5, вам потрібно буде запустити це на штатах, які ви вже обробили, щоб отримати ці додаткові таблиці.

note: Tag: para
en: Generate script to load up data for select states in Windows shell script format.
uk: Створити скрипт для завантаження даних для вибраних штатів у форматі скрипту оболонки Windows.

note: Tag: para
en: Generate sh script
uk: Створити скрипт 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.
uk: Створює скрипт оболонки для вказаної платформи для вказаних станів, який завантажить дані Tiger, підготує та завантажить у схему <varname>tiger_data</varname>. Кожен скрипт стану повертається як окремий запис. Остання версія підтримує структурні зміни Tiger 2010, а також завантажує таблиці перепису, групи блоків та блоки.

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.
uk: Створює скрипт оболонки для вказаної платформи для вказаних станів, який завантажить дані 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.
uk: Для завантаження використовується програма unzip в Linux (7-zip в Windows за замовчуванням) та wget. Для завантаження даних використовується <xref linkend="shp2pgsql_usage"/>. Зверніть увагу, що найменша одиниця, яку обробляє програма, — це весь штат, але ви можете замінити це, завантаживши файли самостійно. Програма обробляє лише файли в папках staging та temp.

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 .
uk: Доступність: 2.0.0 для підтримки структурованих даних Tiger 2010 та завантаження таблиць перепису населення (tract), груп кварталів (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.
uk: Якщо ви використовуєте 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.
uk: Використовуючи psql, де gistest — ваша база даних, а <filename>/gisdata/data_load.sh</filename> — файл, який потрібно створити за допомогою команд оболонки, що виконуються.

note: Tag: para
en: Generate script to load up data for 2 states in Windows shell script format.
uk: Створити скрипт для завантаження даних для 2 штатів у форматі скрипту оболонки Windows.

note: Tag: refpurpose
en: Generates a shell script for the specified platform that loads in the county and state lookup tables.
uk: Створює скрипт оболонки для вказаної платформи, який завантажує таблиці пошуку округів та штатів.

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.
uk: Створює скрипт оболонки для вказаної платформи, який завантажує таблиці <varname>county_all</varname>, <varname>county_all_lookup</varname>, <varname>state_all</varname> у схему <varname>tiger_data</varname>. Вони успадковуються відповідно від таблиць <varname>county</varname>, <varname>county_lookup</varname>, <varname>state</varname> у схемі <varname>tiger</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.
uk: Для завантаження використовується програма unzip в Linux (7-zip в Windows за замовчуванням) та 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.
uk: Він використовує наступні таблиці керування <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.
uk: <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.
uk: Покращено: 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:
uk: Якщо ви хочете, щоб область табуляції поштового індексу 5 (zcta5) була включена в завантаження скрипту вашої країни, виконайте наступні дії:

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.
uk: Якщо ви використовували версію <varname>tiger_2010</varname> і хочете перезавантажити стан з новими даними tiger, перед запуском цього скрипта вам потрібно буде створити та виконати команди drop <xref linkend="Drop_Nation_Tables_Generate_Script"/>.

note: Tag: para
en: Generate script script to load nation data Windows.
uk: Створити скрипт для завантаження національних даних Windows.

note: Tag: para
en: Generate script to load up data for Linux/Unix systems.
uk: Створити скрипт для завантаження даних для систем 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.
uk: Знаходить усі таблиці з ключовими стовпцями, що використовуються в з'єднаннях геокодера, в яких відсутні індекси для цих стовпців, і виводить SQL DDL для визначення індексу для цих таблиць.

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.
uk: Знаходить усі таблиці в схемах <varname>tiger</varname> та <varname>tiger_data</varname> із ключовими стовпцями, що використовуються в з'єднаннях геокодера, для яких відсутні індекси в цих стовпцях, і виводить SQL DDL для визначення індексу для цих таблиць. Це допоміжна функція, яка додає нові індекси, необхідні для прискорення запитів, які могли бути відсутні під час процесу завантаження. У міру вдосконалення геокодера ця функція буде оновлюватися для врахування нових індексів, що використовуються. Якщо ця функція не виводить нічого, це означає, що всі ваші таблиці вже мають, на нашу думку, необхідні ключові індекси.

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).
uk: За заданою текстовою адресою повертає комбінований тип <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.
uk: За заданою текстовою адресою повертає комбінований тип <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.
uk: Ця функція просто використовує різні таблиці пошуку напрямків/станів/суфіксів, попередньо завантажені за допомогою tiger_geocoder і розташовані в схемі <varname>tiger</varname>, тому для її використання не потрібно завантажувати дані перепису tiger або будь-які інші додаткові дані. Можливо, вам знадобиться додати більше скорочень або альтернативних назв до різних таблиць пошуку в схемі <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:
uk: Поля в об'єкті типу <varname>norm_addy</varname>, що повертається цією функцією в такому порядку, де () позначає поле, необхідне для геокодера, [] позначає необов'язкове поле:

note: Tag: para
en: Enhanced: 2.4.0 norm_addy object includes additional fields zip4 and address_alphanumeric.
uk: Покращено: об'єкт norm_addy версії 2.4.0 містить додаткові поля zip4 та address_alphanumeric.

note: Tag: para
en: <varname>address</varname> is an integer: The street number
uk: <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.
uk: <varname>predirAbbrev</varname> є varchar: напрямний префікс дороги, такий як N, S, E, W тощо. Вони контролюються за допомогою таблиці <varname>direction_lookup</varname>.

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.
uk: <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.
uk: <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.
uk: <varname>internal</varname> varchar внутрішня адреса, така як номер квартири або номер кімнати.

note: Tag: para
en: <varname>location</varname> varchar usually a city or governing province.
uk: <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.
uk: <varname>stateAbbrev</varname> varchar два символи, штат США. Наприклад, MA, NY, MI. Вони контролюються таблицею <varname>state_lookup</varname>.

note: Tag: para
en: <varname>zip</varname> varchar 5-digit zipcode. e.g. 02109.
uk: <varname>zip</varname> varchar 5-значний поштовий індекс. Наприклад, 02109.

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.
uk: <varname>parsed</varname> boolean - позначає, чи адреса була сформована в результаті процесу нормалізації. Функція normalize_address встановлює це значення на true перед поверненням адреси.

note: Tag: para
en: <varname>zip4</varname> last 4 digits of a 9 digit zip code. Availability: PostGIS 2.4.0.
uk: <varname>zip4</varname> останні 4 цифри 9-значного поштового індексу. Доступність: 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.
uk: <varname>address_alphanumeric</varname> Повний номер вулиці, навіть якщо він містить літери, наприклад 17R. Розбір цього краще виконувати за допомогою функції <xref linkend="Pagc_Normalize_Address"/>. Доступність: PostGIS 2.4.0.

note: Tag: para
en: Output select fields. Use <xref linkend="Pprint_Addy"/> if you want a pretty textual output.
uk: Поля вибору виводу. Використовуйте <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.
uk: За заданою текстовою адресою повертає комбінований тип <varname>norm_addy</varname>, що містить стандартизовані суфікс, префікс і тип дороги, вулицю, назву вулиці тощо, розділені на окремі поля. Ця функція працює лише з даними пошуку, що містяться в пакеті tiger_geocoder (дані перепису населення tiger не потрібні). Потрібне розширення address_standardizer.

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.
uk: Ця функція використовує різні таблиці пошуку pagc_*, попередньо завантажені за допомогою tiger_geocoder і розташовані в схемі <varname>tiger</varname>, тому для її використання не потрібно завантажувати дані перепису tiger або будь-які інші додаткові дані. Можливо, вам знадобиться додати більше скорочень або альтернативних назв до різних таблиць пошуку в схемі <varname>tiger</varname>.

note: Tag: para
en: There are slight variations in casing and formatting over the <xref linkend="Normalize_Address"/>.
uk: Існують незначні відмінності в оформленні та форматуванні посилання <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:
uk: На даний момент стандартний формат standardaddr розширення address_standardizer є дещо багатшим за norm_addy, оскільки він розроблений для підтримки міжнародних адрес (включно з країною). Еквівалентними полями standardaddr є:

note: Tag: para
en: Single call example
uk: Приклад одного виклику

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"/>.
uk: Пакетний виклик. Наразі існують проблеми зі швидкістю роботи postgis_tiger_geocoder при обробці address_standardizer. Сподіваємося, що ці проблеми будуть вирішені в наступних версіях. Щоб обійти ці проблеми, якщо вам потрібна швидкість для пакетного геокодування, щоб викликати normaddy в пакетному режимі, рекомендуємо безпосередньо викликати функцію standardize_address address_standardizer, як показано нижче, що схоже на те, що ми робили в <xref linkend="Normalize_Address"/>, яке використовує дані, створені в <xref linkend="Geocode"/>.

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.
uk: За заданого об'єкта складеного типу <varname>norm_addy</varname> повертає його представлення у вигляді зручного для друку формату. Зазвичай використовується разом із нормалізацією адреси.

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.
uk: За заданого об'єкта складеного типу <varname>norm_addy</varname> повертає його представлення у вигляді зручного для друку формату. Крім даних, що містяться в геокодері, ніякі інші дані не потрібні.

note: Tag: para
en: Usually used in conjunction with <xref linkend="Normalize_Address"/>.
uk: Зазвичай використовується разом з <xref linkend="Normalize_Address"/>.

note: Tag: para
en: Pretty print a single address
uk: Красивий вивід однієї адреси

note: Tag: para
en: Pretty print address a table of addresses
uk: Красивий вивід таблиці адрес

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.
uk: Бере геометричну точку в відомій просторовій системі координат і повертає запис, що містить масив теоретично можливих адрес і масив перехресних вулиць. Якщо 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.
uk: Бере геометричну точку в відомій просторовій системі координат і повертає запис, що містить масив теоретично можливих адрес і масив перехресних вулиць. Якщо 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.
uk: Чому ми говоримо "теоретичні", а не "фактичні адреси"? Дані Tiger не містять реальних адрес, а лише діапазони вулиць. Таким чином, теоретична адреса є інтерпольованою адресою, що базується на діапазонах вулиць. Наприклад, інтерполяція однієї з моїх адрес дає результат 26 Court St. і 26 Court Sq., хоча такого місця як 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.
uk: Примітка: Ця функція використовує дані Tiger. Якщо ви не завантажили дані, що охоплюють регіон цієї точки, ви отримаєте запис, заповнений нульовими значеннями.

note: Tag: para
en: Returned elements of the record are as follows:
uk: Повернені елементи запису мають такий вигляд:

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.
uk: <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.
uk: <varname>addy</varname> — масив norm_addy (нормалізованих адрес): це масив можливих адрес, які відповідають вхідній точці. Перша в масиві — найімовірніша. Зазвичай має бути тільки одна, за винятком випадків, коли точка знаходиться на розі 2 або 3 вулиць, або точка знаходиться десь на дорозі, а не збоку.

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).
uk: <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.
uk: Покращено: 2.4.1 якщо завантажено опціональний набір даних zcta5, функція reverse_geocode може визначити штат і поштовий індекс, навіть якщо дані про конкретний штат не завантажено. Докладніші відомості про завантаження даних zcta5 див. у <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
uk: Приклад точки на розі двох вулиць, але найближчої до однієї з них. Це приблизне місцезнаходження MIT: 77 Massachusetts Ave, Cambridge, MA 02139 Зверніть увагу, що хоча у нас немає 3 вулиць, 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.
uk: Тут ми вирішили не вказувати діапазони адрес для перехресних вулиць і вибрали місце, яке знаходиться дуже близько до перехрестя двох вулиць, тому його можна знайти за двома різними адресами.

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.
uk: Для цього ми повторно використовуємо наш геокодований приклад з <xref linkend="Geocode"/> і нам потрібна тільки основна адреса і максимум 2 перехресні вулиці.

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.
uk: Завантажує визначену область 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.
uk: Завантажує визначену область даних 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.
uk: Це може бути корисно, наприклад, для перерозподілу даних, коли потрібно, щоб новостворені полігони відповідали центральним лініям вулиць і не перекривали один одного.

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.
uk: Ця функція використовує дані Tiger, а також вимагає встановлення модуля топології PostGIS. Для отримання додаткової інформації див. <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.
uk: Більшість помилок перевірки топології є наслідком проблем з толерантністю, коли після перетворення точки країв не збігаються або перекриваються. Щоб виправити ситуацію, можна збільшити або зменшити точність, якщо виникають помилки перевірки топології.

note: Tag: para
en: Required arguments:
uk: Необхідні аргументи:

note: Tag: para
en: <varname>topo_name</varname> The name of an existing PostGIS topology to load data into.
uk: <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>
uk: <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>
uk: <varname>region_id</varname> Це те, що TIGER називає геоїдом. Це унікальний ідентифікатор регіону в таблиці. Для місця це стовпець <varname>plcidfp</varname> у таблиці <varname>tiger.place</varname>. Для округу це стовпець <varname>cntyidfp</varname> у таблиці <varname>tiger.county</varname>

note: Tag: title
en: Example: Boston, Massachusetts Topology
uk: Приклад: Топологія Бостона та Массачусетс

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.
uk: Створіть топологію для Бостона, штат Массачусетс, у системі Mass State Plane Feet (2249) з допуском 0,25 футів, а потім завантажте грані, ребра та вузли міста Бостон у форматі Tiger.

note: Tag: title
en: Example: Suffolk, Massachusetts Topology
uk: Приклад: Топологія Суффолка та Массачусетс

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.
uk: Створіть топологію для Суффолка, штат Массачусетс, в системі координат Mass State Plane Meters (26986) з похибкою 0,25 метра, а потім завантажте грані, ребра та вузли тигрової моделі округу Суффолк.

note: Tag: refpurpose
en: Sets a setting that affects behavior of geocoder functions.
uk: Встановлює налаштування, що впливає на поведінку функцій геокодера.

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"/>.
uk: Встановлює значення конкретного параметра, збереженого в таблиці <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.
uk: Якщо ви запустите <xref linkend="Geocode"/>, коли ця функція має значення true, у журналі NOTICE буде виведено час виконання та запити.

note: Tag: title
en: Topology
uk: Топологія

note: Tag: para
en: The PostGIS Topology types and functions are used to manage topological objects such as faces, edges and nodes.
uk: Типи та функції топології 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>.
uk: Презентація Сандро Сантіллі на конференції PostGIS Day Paris 2011 містить хороший огляд топології PostGIS та її перспектив <link xlink:href="http://strk.kbt.io/projects/postgis/Paris2011_TopologyWithPostGIS_2_0.pdf">Топологія з PostGIS 2.0, презентація</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>.
uk: Вінсент Пікавет надає хороший огляд та узагальнення того, що таке топологія, як вона використовується, а також різних інструментів 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"/>.
uk: Прикладом топологічної бази даних ГІС є база даних <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.
uk: Модуль топології PostGIS існував у попередніх версіях 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>
uk: Детальнішу інформацію про цей проект можна знайти за посиланням <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>.
uk: Усі функції та таблиці, пов'язані з цим модулем, встановлюються у схемі під назвою <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.
uk: Функції, які визначені в стандарті 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"/>
uk: Підтримка топології вбудована за замовчуванням, починаючи з PostGIS 2.0, і може бути вимкнена, вказавши опцію --without-topology під час компіляції, як описано в <xref linkend="postgis_installation"/>

note: Tag: title
en: Topology Types
uk: Типи топології

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.
uk: У цьому розділі перелічено типи даних PostgreSQL, встановлені PostGIS Topology. Зверніть увагу, що ми описуємо поведінку цих типів при перетворенні, що є дуже важливим, особливо при розробці власних функцій.

note: Tag: refpurpose
en: A composite type that consists of a sequence number and an edge number.
uk: Комбінований тип, що складається з порядкового номера та номера ребра.

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.
uk: Композитний тип, що складається з порядкового номера та номера ребра. Це тип повернення для функцій <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.
uk: <varname>sequence</varname> integer: Посилається на топологію, визначену в таблиці topology.topology, яка визначає схему топології та srid.

note: Tag: para
en: <varname>edge</varname> is an integer: The identifier of an edge.
uk: <varname>edge</varname> integer: ідентифікатор ребра.

note: Tag: refpurpose
en: A composite type representing a topologically defined geometry.
uk: Композитний тип, що представляє топологічно визначену геометрію.

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.
uk: Композитний тип, що посилається на геометрію топології в конкретному шарі топології, має конкретний тип і конкретний ідентифікатор. Елементами 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.
uk: <varname>topology_id</varname> integer: Посилається на топологію, визначену в таблиці topology.topology, яка визначає схему топології та srid.

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.
uk: <varname>layer_id</varname> integer: layer_id у таблиці шарів, до якої належить TopoGeometry. Поєднання 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.
uk: <varname>id</varname> integer: id — це автоматично згенерований порядковий номер, який однозначно визначає топогеометрію у відповідному шарі топології.

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
uk: <varname>type</varname> integer від 1 до 4, що визначає тип геометрії: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection

note: Tag: title
en: Casting Behavior
uk: Поведінка при приведення типів

note: Tag: para
en: This section lists the automatic as well as explicit casts allowed for this data type
uk: У цьому розділі перелічено автоматичні та явні приведення типів, дозволені для цього типу даних

note: Tag: entry
en: Cast To
uk: Приведення типів в

note: Tag: entry
en: Behavior
uk: Поведінка

note: Tag: entry
en: automatic
uk: автоматичне

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>.
uk: Комбінований тип, що складається з повідомлення про помилку та ідентифікаторів 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.
uk: Композитний тип, що складається з повідомлення про помилку та двох цілих чисел. Функція <xref linkend="ValidateTopology"/> повертає набір таких елементів для позначення помилок перевірки, а також ідентифікатори id1 та id2 для позначення ідентифікаторів об'єктів топології, пов'язаних із помилкою.

note: Tag: para
en: <varname>error</varname> is varchar: Denotes type of error.
uk: <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,
uk: Поточні описи помилок: збіжні вузли, перетин ребер з вузлами, не прості ребра, невідповідність геометрії кінцевих вузлів ребер, невідповідність геометрії початкових вузлів ребер, перекриття граней, грань всередині грані,

note: Tag: para
en: <varname>id1</varname> is an integer: Denotes identifier of edge / face / nodes in error.
uk: <varname>id1</varname> integer позначає ідентифікатор ребра / грані / вузлів, що містить помилку.

note: Tag: para
en: <varname>id2</varname> is an integer: For errors that involve 2 objects denotes the secondary edge / or node
uk: <varname>id2</varname> integer: для помилок, що стосуються 2 об'єктів, позначає вторинний край / або вузол

note: Tag: title
en: Topology Domains
uk: Топологічні домени

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.
uk: У цьому розділі перелічено домени PostgreSQL, встановлені PostGIS Topology. Домени можна використовувати як типи об'єктів, наприклад, як об'єкти, що повертаються функціями, або стовпці таблиць. Відмінність домену від типу полягає в тому, що домен — це існуючий тип, до якого прив'язано обмеження перевірки.

note: Tag: refpurpose
en: An array of 2 integers generally used to identify a TopoGeometry component.
uk: Масив із 2 цілих чисел, що зазвичай використовується для ідентифікації компонента TopoGeometry.

note: Tag: para
en: An array of 2 integers used to represent one component of a simple or hierarchical <xref linkend="topogeometry"/>.
uk: Масив із 2 цілих чисел, що використовується для представлення одного компонента простого або ієрархічного <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.
uk: У випадку простої 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.
uk: Для будь-якої ієрархічної TopoGeometry всі дочірні елементи TopoGeometry будуть походити з того самого дочірнього шару, як зазначено в записі topology.layer для шару TopoGeometry, що визначається.

note: Tag: refpurpose
en: An array of TopoElement objects.
uk: Масив об'єктів TopoElement.

note: Tag: para
en: An array of 1 or more TopoElement objects, generally used to pass around components of TopoGeometry objects.
uk: Масив з 1 або більше об'єктів TopoElement, який зазвичай використовується для передачі компонентів об'єктів TopoGeometry.

note: Tag: title
en: Topology and TopoGeometry Management
uk: Управління топологією та топогеометрією

note: Tag: para
en: This section lists the Topology functions for building new Topology schemas, validating topologies, and managing TopoGeometry Columns
uk: У цьому розділі перелічено функції топології для створення нових схем топології, перевірки топологій та управління стовпцями 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.
uk: Додає стовпець топогеометрії до існуючої таблиці, реєструє цей новий стовпець як шар у 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:
uk: Кожен об'єкт TopoGeometry належить до певного шару певної топології. Перед створенням об'єкта TopoGeometry потрібно створити його TopologyLayer. Топологічний шар — це зв'язок таблиці об'єктів з топологією. Він також містить інформацію про тип та ієрархію. Ми створюємо шар за допомогою функції 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.
uk: Ця функція додасть запитуваний стовпець до таблиці та додасть запис до таблиці 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).
uk: Якщо ви не вкажете [child_layer] (або встановите його значення NULL), цей шар буде містити базові топогеометрії (складені з примітивних топологічних елементів). В іншому випадку цей шар буде містити ієрархічні топогеометрії (складені з топогеометрій з child_layer).

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
uk: Після створення шару (його ідентифікатор повертається функцією AddTopoGeometryColumn) ви готові до побудови об'єктів TopoGeometry в ньому

note: Tag: para
en: Valid <varname>feature_type</varname>s are: POINT, MULTIPOINT, LINE, MULTILINE, POLYGON, MULTIPOLYGON, COLLECTION
uk: Дійсні <varname>feature_type</varname>s: POINT, MULTIPOINT, LINE, MULTILINE, POLYGON, MULTIPOLYGON, COLLECTION

note: Tag: para
en: Availability: 1.1
uk: Доступність: 1.1

note: Tag: refpurpose
en: Renames a topogeometry column
uk: Перейменовує стовпець топогеометрії

note: Tag: para
en: This function changes the name of an existing TopoGeometry column ensuring metadata information about it is updated accordingly.
uk: Ця функція змінює назву існуючого стовпця 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.
uk: Використовуйте з обережністю: видаляє схему топології та її посилання з таблиці 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.
uk: Видаляє схему топології та її посилання з таблиці 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.
uk: Cascade видаляє схему ma_topo та всі посилання на неї в topology.topology та geometry_columns.

note: Tag: refpurpose
en: Renames a topology
uk: Перейменовує топологію

note: Tag: para
en: Renames a topology schema, updating its metadata record in the <varname>topology.topology</varname> table.
uk: Перейменовує схему топології, оновлюючи запис метаданих у таблиці <varname>topology.topology</varname>.

note: Tag: para
en: Rename a topology from <varname>topo_stage</varname> to <varname>topo_prod</varname>.
uk: Перейменуйте топологію з <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.
uk: Видаляє стовпець топогеометрії з таблиці з назвою <varname>table_name</varname> у схемі <varname>schema_name</varname> та скасовує реєстрацію стовпців у таблиці 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.
uk: Видаляє стовпець топогеометрії з таблиці з назвою <varname>table_name</varname> у схемі <varname>schema_name</varname> та скасовує реєстрацію стовпців у таблиці topology.layer. Повертає підсумок стану видалення. ПРИМІТКА: перед видаленням спочатку встановлює всі значення на NULL, щоб обійти перевірки цілісності посилань.

note: Tag: refpurpose
en: Adds missing entries to topology.layer table by reading metadata from topo tables.
uk: Додає відсутні записи до таблиці topology.layer, зчитуючи метадані з таблиць topo.

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.
uk: Додає відсутні записи до таблиці <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>.
uk: Повертає список створених записів. Повертаються стовпці <varname>schema_name</varname>, <varname>table_name</varname>, <varname>feature_column</varname>.

note: Tag: para
en: Availability: 2.3.0
uk: Доступність: 2.3.0

note: Tag: refpurpose
en: <refpurpose>Takes a topology name and provides summary totals of types of objects in topology.</refpurpose>
uk: <refpurpose>Бере ім'я топології та надає підсумкові суми типів об'єктів у топології.</refpurpose>

note: Tag: para
en: <para>Takes a topology name and provides summary totals of types of objects in topology.</para>
uk: <para>Бере ім'я топології та надає підсумкові суми типів об'єктів у топології.</para>

note: Tag: refpurpose
en: Returns a set of validatetopology_returntype objects detailing issues with topology.
uk: Повертає набір об'єктів validated_topology_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.
uk: Повертає набір об'єктів <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:
uk: Нижче наведено перелік можливих помилок, їх значення та значення повернених ідентифікаторів:

note: Tag: entry
en: Identifier of first node.
uk: Ідентифікатор першого вузла.

note: Tag: entry
en: Identifier of second node.
uk: Ідентифікатор другого вузла.

note: Tag: entry
en: Two nodes have the same geometry.
uk: Два вузли мають однакову геометрію.

note: Tag: entry
en: Identifier of the edge.
uk: Ідентифікатор ребра.

note: Tag: entry
en: Identifier of the node.
uk: Ідентифікатор вузла.

note: Tag: entry
en: An edge has a node in its interior. See <xref linkend="ST_Relate"/>.
uk: Ребро має вузол у своїй внутрішній частині. Див. <xref linkend="ST_Relate"/>.

note: Tag: entry
en: An edge geometry is invalid. See <xref linkend="ST_IsValid"/>.
uk: Геометрія ребра недійсна. Див. <xref linkend="ST_IsValid"/>.

note: Tag: entry
en: An edge geometry has self-intersections. See <xref linkend="ST_IsSimple"/>.
uk: Геометрія ребра має самоперетини. Див. <xref linkend="ST_IsSimple"/>.

note: Tag: entry
en: Identifier of first edge.
uk: Ідентифікатор першого ребра.

note: Tag: entry
en: Identifier of second edge.
uk: Ідентифікатор другого ребра.

note: Tag: entry
en: Two edges have an interior intersection. See <xref linkend="ST_Relate"/>.
uk: Дві ребра мають внутрішнє перетин. Див. <xref linkend="ST_Relate"/>.

note: Tag: entry
en: Identifier of the indicated start node.
uk: Ідентифікатор вказаного початкового вузла.

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"/>.
uk: Геометрія вузла, вказаного як початковий вузол для ребра, не відповідає першій точці геометрії ребра. Див. <xref linkend="ST_StartPoint"/>.

note: Tag: entry
en: Identifier of the indicated end node.
uk: Ідентифікатор вказаного кінцевого вузла.

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"/>.
uk: Геометрія вузла, вказаного як кінцевий вузол для ребра, не відповідає останній точці геометрії ребра. Див. <xref linkend="ST_EndPoint"/>.

note: Tag: entry
en: Identifier of the orphaned face.
uk: Ідентифікатор "осиротілої" грані.

note: Tag: entry
en: No edge reports an existing face on either of its sides (left_face, right_face).
uk: Жодне ребро не повідомляє про наявність грані з будь-якого боку (left_face, right_face).

note: Tag: entry
en: Identifier of the partially-defined face.
uk: Ідентифікатор частково визначеної грані.

note: Tag: entry
en: Edges reporting a face on their sides do not form a ring.
uk: Ребра, що утворюють грань на своїх боках, не утворюють кільця.

note: Tag: entry
en: Identifier of the face with wrong mbr cache.
uk: Ідентифікатор грані з неправильним кешем 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.
uk: Мінімальна обмежувальна рамка грані не збігається з мінімальною обмежувальною рамкою сукупності ребер, що утворюють грань по своїх сторонах.

note: Tag: entry
en: Signed identifier of an edge, identifying the ring. See <xref linkend="GetRingEdges"/>.
uk: Підписаний ідентифікатор ребра, що ідентифікує кільце. Див. <xref linkend="GetRingEdges"/>.

note: Tag: entry
en: A ring of edges reporting a face on its exterior is contained in different face.
uk: Кільце ребер, що утворюють грань на зовнішній поверхні, міститься в іншій грані.

note: Tag: entry
en: Identifier of the ill-defined node.
uk: Ідентифікатор неправильно визначеного вузла.

note: Tag: entry
en: A node which is reported as being on the boundary of one or more edges is indicating a containing face.
uk: Вузол, який повідомляється як такий, що знаходиться на межі одного або декількох ребер, вказує на вмістну грань.

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.
uk: Вузол, який не вказаний як такий, що знаходиться на межі будь-яких ребер, не має позначення грані, що його містить.

note: Tag: entry
en: Identifier of the misrepresented node.
uk: Ідентифікатор неправильно представленого вузла.

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"/>.
uk: Вузол, який не вказаний як такий, що знаходиться на межі будь-яких ребер, вказує на грань, що його містить, яка не є фактичною гранью, що його містить. Див. <xref linkend="GetFaceContainingPoint"/>.

note: Tag: entry
en: Identifier of the misrepresented edge.
uk: Ідентифікатор неправильно представленого ребра.

note: Tag: entry
en: Signed id of the edge which should be indicated as the next right edge.
uk: Підписаний ідентифікатор ребра, яке слід вказати як наступне праве ребро.

note: Tag: entry
en: The edge indicated as the next edge encountered walking on the right side of an edge is wrong.
uk: Ребро, позначене як наступне ребро, на яке натрапляєш, рухаючись праворуч від ребра, є неправильним.

note: Tag: entry
en: Signed id of the edge which should be indicated as the next left edge.
uk: Підписаний ідентифікатор ребра, яке слід вказати як наступне ліве ребро.

note: Tag: entry
en: The edge indicated as the next edge encountered walking on the left side of an edge is wrong.
uk: Ребро, вказане як наступне ребро, на яке натрапляєш, рухаючись лівою стороною ребра, є неправильним.

note: Tag: entry
en: Edges in a ring indicate conflicting faces on the walking side. This is also known as a "Side Location Conflict".
uk: Ребра в кільці позначають конфліктуючі грані на стороні ходіння. Це також називається "конфліктом розташування сторін".

note: Tag: entry
en: A ring of edges formed by following next_left_edge/next_right_edge attributes starts and ends on different nodes.
uk: Кільце ребер, утворене атрибутами next_left_edge/next_right_edge, починається і закінчується на різних вузлах.

note: Tag: entry
en: Identifier of the contended face.
uk: Ідентифікатор грані, що є предметом суперечки.

note: Tag: entry
en: More than a one ring of edges indicate the same face on its interior.
uk: Більше ніж одне кільце ребер вказує на ту саму грань всередині.

note: Tag: para
en: Availability: 1.0.0
uk: Доступність: 1.0.0

note: Tag: para
en: Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false positives that were existent in prior versions.
uk: Покращено: 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.
uk: Змінено: 2.2.0 значення id1 та id2 були поміняні місцями для "перетину ребер вузлом" з метою узгодження з описом помилки.

note: Tag: para
en: Changed: 3.2.0 added optional bbox parameter, perform face labeling and edge linking checks.
uk: Змінено: 3.2.0 додано опційний параметр bbox, виконується перевірка маркування ребер та з'єднання ребер.

note: Tag: refpurpose
en: Returns info about invalid topology relation records
uk: Повертає інформацію про недійсні записи топологічних відносин

note: Tag: para
en: Returns a set records giving information about invalidities in the relation table of the topology.
uk: Повертає набір записів, що містять інформацію про недійсні елементи в таблиці відносин топології.

note: Tag: para
en: Availability: 3.2.0
uk: Доступність: 3.2.0

note: Tag: refpurpose
en: Returns non-precise vertices in the topology.
uk: Повертає неточні вершини в топології.

note: Tag: para
en: Returns all vertices that are not rounded to the topology or given <varname>gridSize</varname> as a puntal geometry, optionally limiting the check to the area specified by the <varname>bbox</varname> parameter.
uk: Повертає всі вершини, які не округлені до топології або задані <varname>gridSize</varname> як точкова геометрія, опціонально обмежуючи перевірку областю, заданою параметром <varname>bbox</varname>.

note: Tag: para
en: Availability: 3.6.0
uk: Доступність: 3.6.0

note: Tag: refpurpose
en: Snap topology vertices to precision grid.
uk: Прив'язати вершини топології до сітки з високою точністю.

note: Tag: para
en: Snaps all vertices of a topology to the topology precision grid or to the grid whose size is specified with the <varname>gridSize</varname> parameter, optionally limiting the operation to the objects intersecting the area specified by the <varname>bbox</varname> parameter.
uk: Прив'язує всі вершини топології до сітки точності топології або до сітки, розмір якої вказано параметром <varname>gridSize</varname>, за бажанням обмежуючи операцію об'єктами, що перетинають область, вказану параметром <varname>bbox</varname>.

note: Tag: para
en: Snapping could make the topology invalid, so it is recommended to check the outcome of operation with <xref linkend="ValidateTopology"/>.
uk: При використанні функції "Прив'язати" топологія може стати недійсною, тому рекомендується перевірити результат операції за допомогою <xref linkend="ValidateTopology"/>.

note: Tag: refpurpose
en: Returns a topology record by different means.
uk: Повертає запис топології різними способами.

note: Tag: para
en: Takes a topology identifier or the identifier of a topology-related object and returns a topology.topology record.
uk: Приймає ідентифікатор топології або ідентифікатор об'єкта, пов'язаного з топологією, і повертає запис топології.

note: Tag: refpurpose
en: Returns a topology.layer record by different means.
uk: Повертає запис topology.layer різними способами.

note: Tag: para
en: Takes a layer identifier or the identifier of a topology-related object and returns a topology.layer record.
uk: Приймає ідентифікатор шару або ідентифікатор об'єкта, пов'язаного з топологією, і повертає запис topology.layer.

note: Tag: refpurpose
en: Total disk space used by the specified topology, including all indexes and TOAST data.
uk: Загальний обсяг дискового простору, використовуваний зазначеною топологією, включаючи всі індекси та дані TOAST.

note: Tag: para
en: Takes a topology name and provides the total disk space used by all its tables, including indexes and TOAST data.
uk: Приймає ім'я топології та надає загальний обсяг дискового простору, зайнятого всіма її таблицями, включаючи індекси та дані TOAST.

note: Tag: refpurpose
en: Upgrades the specified topology to support large ids (int8) for topology and primitive ids.
uk: Оновлює вказану топологію для підтримки великих ідентифікаторів (int8) для топології та примітивних ідентифікаторів.

note: Tag: para
en: Takes a topology name and upgrades it to support large ids (int8) for topology and primitive ids. The function upgrades the following: - face (face_id column from int4 to int8, face_id_seq from int4 to int8) - node (node_id column from int4 to int8, containing_face column from int4 to int8, node_id_seq from int4 to int8) - edge_data (edge_id column from int4 to int8, edge_data_edge_id_seq from int4 to int8, left_face and right_face columns from int4 to int8, start_node and end_node columns from int4 to int8, next_left_edge and next_right_edge columns from int4 to int8) - relation (topogeo_id column from int4 to int8, element_id from int4 to int8) - topology (useslargeids column set to true)
uk: Бере ім'я топології та оновлює його для підтримки великих ідентифікаторів (int8) для топології та примітивних ідентифікаторів. Функція оновлює наступне: - face (стовпець face_id з int4 до int8, face_id_seq з int4 до int8) - node (стовпець node_id з int4 до int8, столпець containing_face з int4 до int8, node_id_seq з int4 до int8) - edge_data (стовпець edge_id з int4 до int8, edge_data_edge_id_seq з int4 до int8, стовпці left_face та right_face з int4 до int8, стовпці start_node та end_node з int4 до int8, стовпці next_left_edge та next_right_edge з int4 до int8) - relation (стовпець topogeo_id з int4 до int8, element_id з int4 до int8) - topology (стовпець useslargeids встановлено на true)

note: Tag: title
en: Topology Statistics Management
uk: Управління статистикою топології

note: Tag: para
en: This section discusses management of database statistics during topology building.
uk: У цьому розділі розглядається управління статистикою бази даних під час побудови топології.

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.
uk: Додавання елементів до топології викликає багато запитів до бази даних для пошуку існуючих ребер, які будуть розділені, додавання вузлів та оновлення ребер, які будуть з'єднані з новою лінією. З цієї причини корисно, щоб статистичні дані про дані в таблицях топології були актуальними.

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.
uk: Функції заповнення та редагування топології 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.
uk: Статистика, оновлена за допомогою autovacuum, НЕ буде видима для транзакцій, які були запущені до завершення процесу autovacuum, тому для використання оновленої статистики довготривалі транзакції повинні самостійно виконати ANALYZE.

note: Tag: title
en: Topology Constructors
uk: Конструктори топології

note: Tag: para
en: This section covers the topology functions for creating new topologies.
uk: У цьому розділі описано функції топології для створення нових топологій.

note: Tag: refpurpose
en: Creates a new topology schema and registers it in the topology.topology table.
uk: Створює нову схему топології та реєструє її в таблиці 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.
uk: Створює нову схему топології з іменем <varname>topology_name</varname> і реєструє її в таблиці <varname>topology.topology</varname>. Топології повинні мати унікальні імена. Таблиці топологій (<varname>edge_data</varname>, <varname>face</varname>, <varname>node</varname> та <varname>relation</varname> створюються в схемі. Повертає ідентифікатор топології.

note: Tag: para
en: The <varname>srid</varname> is the <link linkend="spatial_ref_sys">spatial reference system</link> SRID for the topology. The SRID defaults to -1 (unknown) if not specified.
uk: <varname>srid</varname> — це SRID <link linkend="spatial_ref_sys">просторової системи координат</link> для топології. Якщо SRID не вказано, за замовчуванням використовується значення -1 (невідомо).

note: Tag: para
en: The tolerance <varname>prec</varname> is measured in the units of the spatial reference system. The tolerance defaults to 0.
uk: Допуск <varname>prec</varname> вимірюється в одиницях просторової системи відліку. За замовчуванням допуск дорівнює 0.

note: Tag: para
en: <varname>hasz</varname> defaults to false if not specified.
uk: <varname>hasz</varname> за замовчуванням має значення false, якщо не вказано інше.

note: Tag: para
en: <varname>topoid</varname> optional explicit identifier (allows deterministic topology id assignment, needs to be unique)
uk: <varname>topoid</varname> необов'язковий явний ідентифікатор (дозволяє детерміновано присвоювати ідентифікатори топології, повинен бути унікальним)

note: Tag: para
en: <varname>useslargeids</varname> optional, defaults to false. If true, the topology will be created to support large ids (int8) for topology and primitive ids.
uk: <varname>useslargeids</varname> необов'язковий, за замовчуванням false. Якщо true, то топологія буде створена для підтримки великих ідентифікаторів (int8) для топології та примітивних ідентифікаторів.

note: Tag: para
en: This is similar to the SQL/MM <xref linkend="ST_InitTopoGeo"/> but has more functionality.
uk: Це схоже на SQL/MM <xref linkend="ST_InitTopoGeo"/>, але має більше функціональних можливостей.

note: Tag: para
en: Enhanced: 2.0 added the signature accepting hasZ
uk: Покращено: у версії 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.
uk: Створіть схему топології під назвою <varname>ma_topo</varname>, яка зберігає ребра та вузли в системі координат Massachusetts State Plane-meters (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)
uk: Створіть топологію для Род-Айленду під назвою <varname>ri_topo</varname> у системі просторових координат State Plane-feet (SRID = 3438)

note: Tag: refpurpose
en: Makes a copy of a topology (nodes, edges, faces, layers and TopoGeometries) into a new schema
uk: Створює копію топології (вузлів, ребер, граней, шарів і TopoGeometries) у новій схемі

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.
uk: Створює нову топологію з назвою <varname>new_name</varname>, з SRID і точністю, скопійованими з <varname>existing_topology_name</varname>. Вузли, ребра та грані в <varname>existing_topology_name</varname> копіюються в нову топологію, а також шари та пов'язані з ними TopoGeometries.

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.
uk: Нові рядки в таблиці <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>.
uk: Створіть резервну копію топології під назвою <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.
uk: Це еквівалент SQL-MM для <xref linkend="CreateTopology"/>. У ньому відсутні параметри для просторової системи координат і допуску. Він повертає текстовий опис створення топології замість ідентифікатора топології.

note: Tag: refpurpose
en: <refpurpose>Adds a collection of geometries to a given empty topology and returns a message detailing success.</refpurpose>
uk: <refpurpose>Додає колекцію геометрій до заданої порожньої топології та повертає повідомлення з детальною інформацією про успішність операції.</refpurpose>

note: Tag: para
en: <para>Adds a collection of geometries to a given empty topology and returns a message detailing success.</para>
uk: <para>Додає колекцію геометрій до заданої порожньої топології та повертає повідомлення з детальною інформацією про успішність виконання.</para>

note: Tag: para
en: Useful for populating an empty topology.
uk: Корисно для заповнення порожньої топології.

note: Tag: para
en: Availability: 2.0
uk: Доступність: 2.0

note: Tag: refpurpose
en: Adds a point to an existing topology using a tolerance and possibly splitting an existing edge.
uk: Додає точку до існуючої топології, використовуючи допуск і, можливо, розділяючи існуюче ребро.

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.
uk: Додає точку до існуючої топології та повертає її ідентифікатор. Задана точка буде прив'язана до існуючих вузлів або ребер в межах заданого допуску. Існуюче ребро може бути розділене прив'язаною точкою.

note: Tag: refpurpose
en: Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces.
uk: Додає лінійний елемент до існуючої топології з використанням допуску та можливого розділення існуючих ребер/граней.

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.
uk: Додає лінійний рядок до існуючої топології та повертає набір підписаних ідентифікаторів ребер, що його утворюють (негативні ідентифікатори означають, що ребро йде в протилежному напрямку від вхідного лінійного рядка). Задана лінія буде прив'язана до існуючих вузлів або ребер в межах заданого допуску. Існуючі ребра та грані можуть бути розділені лінією. Можуть бути додані нові вузли та грані.

note: Tag: para
en: Updating statistics about topologies being loaded via this function is up to caller, see <xref linkend="Topology_StatsManagement"/>.
uk: Оновлення статистики про топології, що завантажуються за допомогою цієї функції, залежить від виклику, див. <xref linkend="Topology_StatsManagement"/>.

note: Tag: para
en: Enhanced: 3.2.0 added support for returning signed identifier.
uk: Покращено: у версії 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.
uk: Додає полігон до існуючої топології, використовуючи допуск і, можливо, розділяючи існуючі ребра/грані. Повертає ідентифікатори граней.

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.
uk: Додає полігон до існуючої топології та повертає набір ідентифікаторів граней, що його утворюють. Межа заданого полігону буде прив'язана до існуючих вузлів або ребер з урахуванням заданого допуску. Існуючі ребра та грані можуть бути розділені межею нового полігону.

note: Tag: refpurpose
en: Load a geometry into an existing topology, snapping and splitting as needed.
uk: Завантажте геометрію в існуючу топологію, при необхідності вирівнюючи та розділяючи.

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.
uk: Завантажує геометрію в існуючу топологію. Задана геометрія буде прив'язана до існуючих вузлів або ребер в межах заданого допуску. Існуючі ребра та грані можуть бути розділені в результаті завантаження.

note: Tag: para
en: Availability: 3.5.0
uk: Доступність: 3.5.0

note: Tag: title
en: Topology Editors
uk: Редактори топології

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.
uk: Цей розділ охоплює функції топології для додавання, переміщення, видалення та розділення ребер, граней та вузлів. Усі ці функції визначені стандартом 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.
uk: Додає ізольований вузол до грані в топології та повертає ідентифікатор нового вузла. Якщо грань має нульове значення, вузол все одно створюється.

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.
uk: Додає ізольований вузол із точкою розташування <varname>apoint</varname> до існуючої грані з ідентифікатором грані <varname>aface</varname> до топології <varname>atopology</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.
uk: Якщо система просторових координат (srid) геометрії точки не збігається з топологією, <varname>apoint</varname> не є геометрією точки, точка є нульовою або точка перетинає існуючу ребро (навіть на межі), то виникає виняток. Якщо точка вже існує як вузол, виникає виняток.

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.
uk: Якщо <varname>aface</varname> не дорівнює нулю, а <varname>apoint</varname> не знаходиться в межах грані, то генерується виняток.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Net Routines: X+1.3.1
uk: &sqlmm_compliant; SQL-MM: Топо-мережеві процедури: X+1.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>
uk: <refpurpose>Додає ізольоване ребро, визначене геометрією <varname>alinestring</varname>, до топології, що з'єднує два існуючі ізольовані вузли <varname>anode</varname> та <varname>anothernode</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>
uk: <para>Додає ізольоване ребро, визначене геометрією <varname>alinestring</varname>, до топології, що з'єднує два існуючі ізольовані вузли <varname>anode</varname> та <varname>anothernode</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.
uk: Якщо система просторових посилань (srid) геометрії <varname>alinestring</varname> не збігається з топологією, будь-який з вхідних аргументів має значення 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.
uk: Якщо <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.
uk: Якщо <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
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 3: Деталі процедури: X.3

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.
uk: Додайте нову ребро і, якщо при цьому розділяється грань, видаліть оригінальну грань і замініть її двома новими.

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.
uk: Додайте нове ребро і, якщо при цьому розділяється грань, видаліть оригінальну грань і замініть її двома новими гранями. Повертає ідентифікатор новододаного ребра.

note: Tag: para
en: Updates all existing joined edges and relationships accordingly.
uk: Відповідно оновлює всі існуючі з'єднані ребра та взаємозв'язки.

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.
uk: Якщо будь-які аргументи мають нульове значення, вказані вузли невідомі (повинні вже існувати в таблиці <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.
uk: Якщо система просторових посилань (srid) геометрії <varname>acurve</varname> не збігається з топологією, виникає виняток.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 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.
uk: Додайте нову кромку і, якщо при цьому розділяється грань, змініть вихідну грань і додайте нову.

note: Tag: para
en: Add a new edge and, if doing so splits a face, modify the original face and add a new one.
uk: Додайте нове ребро і, якщо це призведе до розділення грані, змініть оригінальну грань і додайте нову.

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).
uk: Якщо можливо, нова грань буде створена зліва від нового ребра. Це буде неможливо, якщо грань зліва повинна бути необмеженою.

note: Tag: para
en: Returns the id of the newly added edge.
uk: Повертає ідентифікатор новододаного ребра.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 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>
uk: <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>
uk: <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).
uk: Повертає ідентифікатор новоствореної грані або 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).
uk: Відмовляється видаляти край, що бере участь у визначенні існуючої 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.
uk: Якщо будь-які аргументи мають нульове значення, задана ребро невідома (повинна вже існувати в таблиці <varname>edge</varname> схеми топології), ім'я топології недійсне, то генерується помилка.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 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.
uk: Видаляє ребро, і якщо ребро розділяє дві грані, видаляє одну грань і модифікує іншу грань, щоб покрити простір обох.

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.
uk: Видаляє ребро, і якщо видалене ребро розділяє дві грані, видаляє одну грань і модифікує іншу грань, щоб покрити простір обох. Переважно зберігає грань праворуч, щоб забезпечити узгодженість з <xref linkend="ST_AddEdgeModFace"/>. Повертає ідентифікатор грані, яка зберігається.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 3: Деталі процедури: X.3.15

note: Tag: refpurpose
en: <refpurpose>Changes the shape of an edge without affecting the topology structure.</refpurpose>
uk: <refpurpose>Змінює форму ребра, не впливаючи на топологічну структуру.</refpurpose>

note: Tag: para
en: <para>Changes the shape of an edge without affecting the topology structure.</para>
uk: <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.
uk: Якщо будь-які аргументи мають значення null, задана ребро не існує в таблиці <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.
uk: Якщо новий <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.
uk: Якщо переміщення ребра зі старого положення в нове призведе до зіткнення з перешкодою, буде видано помилку.

note: Tag: para
en: Availability: 1.1.0
uk: Доступність: 1.1.0

note: Tag: para
en: Enhanced: 2.0.0 adds topological consistency enforcement
uk: Покращено: у версії 2.0.0 додано забезпечення топологічної узгодженості

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 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.
uk: Розділіть ребро, створивши новий вузол уздовж існуючого ребра, змінивши оригінальне ребро та додавши нове.

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.
uk: Розділити ребро, створивши новий вузол уздовж існуючого ребра, змінивши оригінальне ребро та додавши нове ребро. Відповідно оновлює всі існуючі з'єднані ребра та відносини. Повертає ідентифікатор новододаного вузла.

note: Tag: para
en: Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit
uk: Змінено: 2.0 — у попередніх версіях це було неправильно названо ST_ModEdgesSplit

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 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.
uk: Виправляє двa ребра, видаляючи вузол, що їх з'єднує, змінюючи перше ребро та видаляючи друге ребро. Повертає ідентифікатор видаленого вузла.

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.
uk: Виправляє два ребра, видаляючи вузол, що їх з'єднує, змінюючи перше ребро та видаляючи друге ребро. Повертає ідентифікатор видаленого вузла. Відповідно оновлює всі існуючі з'єднані ребра та відносини.

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.
uk: Відновлює два ребра, видаляючи вузол, що їх з'єднує, видаляючи обидва ребра та замінюючи їх ребром, напрямок якого збігається з напрямком першого наданого ребра.

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.
uk: Виправляє дві ребра, видаляючи вузол, що їх з'єднує, видаляючи обидві ребра та замінюючи їх ребром, напрямок якого збігається з напрямком першого наданого ребра. Повертає ідентифікатор нового ребра, що замінює виправлені ребра. Відповідно оновлює всі існуючі з'єднані ребра та відносини.

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.
uk: Переміщує ізольований вузол у топології з однієї точки в іншу. Якщо нова геометрія <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.
uk: Переміщує ізольований вузол у топології з однієї точки в іншу. Якщо нова геометрія <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.
uk: Якщо будь-які аргументи мають нульове значення, <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.
uk: Якщо система просторових координат (srid) геометрії точки не збігається з топологією, генерується виняток.

note: Tag: para
en: Enhanced: 3.2.0 ensures the nod cannot be moved in a different face
uk: Покращено: версія 3.2.0 гарантує, що вузол не можна перемістити на іншу грань

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.2
uk: &sqlmm_compliant; SQL-MM: Процедури Topo-Net: 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.
uk: Розділіть ребро, створивши новий вузол уздовж існуючого ребра, видаливши оригінальне ребро і замінивши його двома новими ребрами. Повертає ідентифікатор нового вузла, створеного для з'єднання нових ребер.

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.
uk: Розділити ребро з ідентифікатором <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.
uk: Якщо система просторових посилань (srid) геометрії точки не збігається з топологією, <varname>apoint</varname> не є геометрією точки, точка є нульовою, точка вже існує як вузол, край не відповідає існуючому краю або точка не знаходиться в межах краю, то генерується виняток.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.8
uk: &sqlmm_compliant; SQL-MM: Процедури Topo-Net: 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>
uk: <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>
uk: <para>Видаляє ізольований вузол і повертає опис дії. Якщо вузол не ізольований (є початком або кінцем ребра), то генерується виняток.</para>

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3
uk: &sqlmm_compliant; SQL-MM: Topo-Geo та Topo-Net 3: Деталі процедури: X+1.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>
uk: <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>
uk: <para>Видаляє ізольовану грань і повертає опис дії. Якщо грань не ізольована, то генерується виняток.</para>

note: Tag: title
en: Topology Accessors
uk: Топологічні методи доступу

note: Tag: refpurpose
en: Finds the edge-id of an edge that intersects a given point.
uk: Знаходить ідентифікатор ребра, яке перетинає задану точку.

note: Tag: para
en: Retrieves the id of an edge that intersects a Point.
uk: Отримує ідентифікатор ребра, яке перетинає точку.

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.
uk: Функція повертає ціле число (id-edge) за заданою топологією, точкою POINT і допуском tolerance. Якщо tolerance = 0, то точка повинна перетинати край.

note: Tag: para
en: If <varname>apoint</varname> doesn't intersect an edge, returns 0 (zero).
uk: Якщо <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.
uk: Якщо використання tolerance &gt; 0 і поблизу точки є більше ніж одна грань, то виникає виняток.

note: Tag: para
en: If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin.
uk: Якщо tolerance = 0, функція використовує ST_Intersects, в іншому випадку використовує ST_DWithin.

note: Tag: para
en: Performed by the GEOS module.
uk: Виконується модулем GEOS.

note: Tag: para
en: These examples use edges we created in <xref linkend="AddEdge"/>
uk: У цих прикладах використовуються ребра, які ми створили в <xref linkend="AddEdge"/>

note: Tag: refpurpose
en: Finds face intersecting a given point.
uk: Знаходить грань, що перетинає задану точку.

note: Tag: para
en: Finds a face referenced by a Point, with given tolerance.
uk: Знаходить грань, на яку вказує точка, з заданим допуском.

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.
uk: Функція ефективно шукатиме грань, що перетинає коло з центром у точці та радіусом, що відповідає допуску.

note: Tag: para
en: If no face intersects the given query location, 0 is returned (universal face).
uk: Якщо жодна поверхня не перетинає задане місце пошуку, повертається 0 (універсальна поверхня).

note: Tag: para
en: If more than one face intersect the query location an exception is thrown.
uk: Якщо більше ніж одна грань перетинає місце запиту, генерується виняток.

note: Tag: para
en: Enhanced: 3.2.0 more efficient implementation and clearer contract, stops working with invalid topologies.
uk: Покращено: 3.2.0 більш ефективна реалізація та чіткіший контракт, припиняє роботу з недійсними топологіями.

note: Tag: refpurpose
en: Finds the face containing a point.
uk: Знаходить обличчя, що містить точку.

note: Tag: para
en: Returns the id of the face containing a point.
uk: Повертає ідентифікатор грані, що містить точку.

note: Tag: para
en: An exception is thrown if the point falls on a face boundary.
uk: Якщо точка потрапляє на межу грані, генерується виняток.

note: Tag: para
en: The function relies on a valid topology, using edge linking and face labeling.
uk: Функція базується на дійсній топології, використовуючи зв'язки між ребрами та маркування граней.

note: Tag: refpurpose
en: Finds the node-id of a node at a point location.
uk: Знаходить ідентифікатор вузла в точці.

note: Tag: para
en: Retrieves the id of a node at a point location.
uk: Отримує ідентифікатор вузла в точці розташування.

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.
uk: Функція повертає ціле число (id-node) за заданою топологією, POINT і допуском. Якщо допуск = 0, це означає точне перетин, в іншому випадку витягує вузол з інтервалу.

note: Tag: para
en: If <varname>apoint</varname> doesn't intersect a node, returns 0 (zero).
uk: Якщо <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.
uk: Якщо використання tolerance &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>
uk: <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>
uk: <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.
uk: Повертає SRID топології в таблиці topology.topology, задавши ім'я топології.

note: Tag: para
en: Returns the spatial reference id of a topology in the topology.topology table given the name of the topology.
uk: Повертає ідентифікатор просторового посилання топології в таблиці topology.topology за назвою топології.

note: Tag: refpurpose
en: Returns the name of a topology (schema) given the id of the topology.
uk: Повертає назву топології (схеми) за ідентифікатором топології.

note: Tag: para
en: Returns the topology name (schema) of a topology from the topology.topology table given the topology id of the topology.
uk: Повертає ім'я топології (схему) з таблиці topology.topology, задавши ідентифікатор топології.

note: Tag: refpurpose
en: Returns a set of ordered edges that bound <varname>aface</varname>.
uk: Повертає набір впорядкованих ребер, що обмежують <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.
uk: Повертає набір впорядкованих ребер, що обмежують <varname>aface</varname>. Кожен вихідний елемент складається з послідовності та edgeid. Номери послідовності починаються з значення 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).
uk: Перелік кожного краю кільця починається з краю з найменшим ідентифікатором. Порядок країв відповідає правилу лівої руки (межа знаходиться ліворуч від кожного спрямованого краю).

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5
uk: &sqlmm_compliant; SQL-MM 3 Topo-Geo та Topo-Net 3: Деталі процедури: X.3.5

note: Tag: refpurpose
en: Returns the polygon in the given topology with the specified face id.
uk: Повертає багатокутник у заданій топології із зазначеним ідентифікатором грані.

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.
uk: Повертає багатокутник у заданій топології із зазначеним ідентифікатором грані. Будує багатокутник із ребер, що утворюють грань.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16
uk: &sqlmm_compliant; SQL-MM 3 Topo-Geo та Topo-Net 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.
uk: Повертає впорядкований набір ідентифікаторів підписаних ребер, зустрітих при проходженні по заданій стороні ребра.

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.
uk: Повертає впорядкований набір ідентифікаторів підписаних ребер, зустрінутих під час проходження по заданій стороні ребра. Кожен вихідний елемент складається з послідовності та ідентифікатора підписаного ребра. Номери послідовності починаються з значення 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.
uk: Якщо ви передаєте позитивний ідентифікатор ребра, проходження починається з лівого боку відповідного ребра і слідує за напрямком ребра. Якщо ви передаєте негативний ідентифікатор ребра, проходження починається з правого боку ребра і йде назад.

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.
uk: Якщо <varname>max_edges</varname> не дорівнює нулю, функція повертає не більше цих записів. Це є параметром безпеки при роботі з потенційно недійсними топологіями.

note: Tag: para
en: This function uses edge ring linking metadata.
uk: Ця функція використовує метадані зв'язку крайових кілець.

note: Tag: refpurpose
en: Returns an ordered set of edges incident to the given node.
uk: Повертає впорядкований набір ребер, що прилягають до заданого вузла.

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.
uk: Повертає впорядкований набір ребер, що прилягають до заданого вузла. Кожен вихідний елемент складається з послідовності та ідентифікатора ребра зі знаком. Номери послідовності починаються з 1. Позитивне ребро починається в заданому вузлі. Негативне ребро закінчується в заданому вузлі. Замкнуті ребра з'являються двічі (з обома знаками). Порядок визначається за годинниковою стрілкою, починаючи з півночі.

note: Tag: para
en: This function computes ordering rather than deriving from metadata and is thus usable to build edge ring linking.
uk: Ця функція обчислює порядок, а не виводить його з метаданих, і тому може використовуватися для побудови зв'язків між кільцями ребер.

note: Tag: title
en: Topology Processing
uk: Обробка топології

note: Tag: para
en: This section covers the functions for processing topologies in non-standard ways.
uk: Цей розділ описує функції для обробки топологій нестандартними способами.

note: Tag: refpurpose
en: Finds and registers all faces defined by topology edges.
uk: Знаходить і реєструє всі грані, визначені краями топології.

note: Tag: para
en: Registers all faces that can be built out a topology edge primitives.
uk: Реєструє всі грані, які можна побудувати з примітивів ребер.

note: Tag: para
en: The target topology is assumed to contain no self-intersecting edges.
uk: Припускається, що цільова топологія не містить самоперетинаючих ребер.

note: Tag: para
en: Already known faces are recognized, so it is safe to call Polygonize multiple times on the same topology.
uk: Вже відомі грані розпізнаються, тому можна безпечно викликати 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.
uk: Ця функція не використовує і не встановлює поля 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.
uk: Додає точковий вузол до таблиці вузлів у вказаній схемі топології та повертає ідентифікатор нового вузла. Якщо точка вже існує як вузол, повертається існуючий ідентифікатор вузла.

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.
uk: Додає точковий вузол до таблиці вузлів у вказаній схемі топології. Функція <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.
uk: Якщо виявлено будь-яке ребро, що перетинає вузол, то, залежно від значення параметра <varname>allowEdgeSplitting</varname>, або генерується виняток, або ребро розділяється.

note: Tag: para
en: If <varname>computeContainingFace</varname> is true a newly added node would get the correct containing face computed.
uk: Якщо <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.
uk: Якщо геометрія <varname>apoint</varname> вже існує як вузол, вузол не додається, а повертається існуючий nodeid.

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.
uk: Додає лінійний край до таблиці країв ребер та пов'язані початкові та кінцеві точки до таблиці вузлів точок заданої топологічної схеми, використовуючи задану геометрію лінійного ребра, та повертає ідентифікатор нового (або існуючого) ребра.

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.
uk: Додає ребро до таблиці ребер і пов'язані вузли до таблиці вузлів заданої схеми <varname>toponame</varname> з використанням заданої геометрії лінійного рядка та повертає edgeid нового або існуючого запису. Новододане ребро має обох боків "універсум" і пов'язане саме з собою.

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.
uk: Якщо геометрія <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.
uk: Геометрія <varname>aline</varname> повинна мати той самий <varname>srid</varname>, що визначений для топології, інакше буде видано помилку недійсного просторового посилання sys.

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="TopoGeo_AddLineString"/> instead.
uk: застаріло з версії 3.5.0. Замість цього використовуйте <xref linkend="TopoGeo_AddLineString"/>.

note: Tag: refpurpose
en: <refpurpose>Registers a face primitive to a topology and gets its identifier.</refpurpose>
uk: <refpurpose>Реєструє примітив грані в топології та отримує його ідентифікатор.</refpurpose>

note: Tag: para
en: <para>Registers a face primitive to a topology and gets its identifier.</para>
uk: <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.
uk: Для новододаної грані краї, що утворюють її межі, та краї, що містяться в грані, будуть оновлені, щоб мати правильні значення в полях 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.
uk: Припускається, що топологія цілі є правильною (не містить самоперетинаючих ребер). Виникає виняток, якщо: Межа багатокутника не повністю визначена існуючими ребрами або багатокутник перетинає існуючу грань.

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.
uk: Якщо геометрія <varname>apolygon</varname> вже існує як грань, то: якщо <varname>force_new</varname> має значення false (за замовчуванням), повертається ідентифікатор існуючої грані; якщо <varname>force_new</varname> має значення true, новому зареєстрованому грані присвоюється новий ідентифікатор.

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.
uk: Коли виконується нова реєстрація існуючої грані (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.
uk: Геометрія <varname>apolygon</varname> повинна мати той самий <varname>srid</varname>, що визначено для топології, інакше буде видано помилку недійсного просторового посилання sys.

note: Tag: refpurpose
en: Returns a "simplified" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm.
uk: Повертає "спрощену" версію геометрії заданої TopoGeometry за допомогою алгоритму Дугласа-Пеукера.

note: Tag: para
en: Returns a "simplified" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm on each component edge.
uk: Повертає "спрощену" геометрію заданої TopoGeometry, використовуючи алгоритм Дугласа-Пеукера для кожного компонента ребра.

note: Tag: para
en: The returned geometry may be non-simple or non-valid.
uk: Повернена геометрія може бути неспрощеною або недійсна.

note: Tag: para
en: Splitting component edges may help retaining simplicity/validity.
uk: Розділення граней компонентів може допомогти зберегти простоту/дійсність.

note: Tag: para
en: Geometry <xref linkend="ST_Simplify"/>, <xref linkend="ST_IsSimple"/>, <xref linkend="ST_IsValid"/>, <xref linkend="ST_ModEdgeSplit"/>
uk: Геометрія <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.
uk: Видаляє примітивні елементи топології, які не потрібні для визначення існуючих об'єктів 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.
uk: Знаходить всі примітиви (вузли, ребра, грані), які не є строго необхідними для представлення існуючих об'єктів TopoGeometry, і видаляє їх, зберігаючи топологічну валідність (зв'язки ребер, маркування граней) і зайнятість простору TopoGeometry.

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).
uk: Нові примітивні ідентифікатори не створюються, а існуючі примітиви розширюються, щоб включити об'єднані грані (після видалення ребер) або відновлені ребра (після видалення вузлів).

note: Tag: para
en: Availability: 3.3.0
uk: Доступність: 3.3.0

note: Tag: title
en: TopoGeometry Constructors
uk: Конструктори топогеометрії

note: Tag: para
en: This section covers the topology functions for creating new topogeometries.
uk: Цей розділ присвячений функціям топології для створення нових топогеометрій.

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
uk: Створює новий об'єкт топографічної геометрії з масиву топографічних елементів - 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.
uk: Створює об'єкт топогеометрії для шару, позначеного <varname>layer_id</varname>, і реєструє його в таблиці відносин у схемі <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.
uk: <varname>tg_type</varname> є цілим числом: 1:[multi]point (точкова), 2:[multi]line (лінійна), 3:[multi]poly (площа), 4:колекція. <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.
uk: пунктуальні шари утворюються з набору вузлів, лінійні шари утворюються з набору ребер, площинні шари утворюються з набору граней, а колекції можуть утворюватися з суміші вузлів, ребер і граней.

note: Tag: para
en: Omitting the array of components generates an empty TopoGeometry object.
uk: Пропуск масиву компонентів призводить до створення порожнього об'єкта TopoGeometry.

note: Tag: title
en: Examples: Form from existing edges
uk: Приклади: Форма з існуючих ребер

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>).
uk: Створіть топогеометрію в схемі ri_topo для шару 2 (наш ri_roads) типу (2) LINE для першого ребра (ми завантажили в <varname>ST_CreateTopoGeo</varname>).

note: Tag: title
en: Examples: Convert an areal geometry to best guess topogeometry
uk: Приклади: Перетворення плоскої геометрії в найкраще наближену топогеометрію

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:
uk: Припустимо, ми маємо геометрії, які повинні бути сформовані з набору граней. Наприклад, ми маємо таблицю груп блоків і хочемо знати топологічну геометрію кожної групи блоків. Якщо наші дані були б ідеально вирівняні, ми могли б зробити так:

note: Tag: refpurpose
en: Converts a simple Geometry into a topo geometry.
uk: Перетворює просту геометрію в топологічну геометрію.

note: Tag: para
en: Converts a simple Geometry into a <xref linkend="topogeometry"/>.
uk: Перетворює просту геометрію в <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.
uk: Топологічні примітиви, необхідні для представлення вхідної геометрії, будуть додані до базової топології, можливо з розділенням існуючих, і будуть пов'язані з вихідною TopoGeometry в таблиці <varname>relation</varname>.

note: Tag: para
en: Existing TopoGeometry objects (with the possible exception of <varname>topogeom</varname>, if given) will retain their shapes.
uk: Існуючі об'єкти 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.
uk: Коли вказано <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>).
uk: У першій формі буде створено нову топогеометрію для заданого шару (<varname>layer_id</varname>) заданої топології (<varname>toponame</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"/>.
uk: У другій формі примітиви, отримані в результаті перетворення, будуть додані до існуючої TopoGeometry (<varname>topogeom</varname>), можливо, додаючи простір до її остаточної форми. Щоб нова форма повністю замінила стару, див. <xref linkend="clearTopoGeom"/>.

note: Tag: para
en: Enhanced: 2.1.0 adds the version taking an existing TopoGeometry.
uk: Покращено: у версії 2.1.0 додано версію, що використовує існуючу TopoGeometry.

note: Tag: para
en: This is a full self-contained workflow
uk: Це повністю автономний робочий процес

note: Tag: refpurpose
en: Returns a <varname>topoelementarray</varname> for a set of element_id, type arrays (topoelements).
uk: Повертає <varname>topoelementarray</varname> для набору масивів element_id, type (topoelements).

note: Tag: para
en: Used to create a <xref linkend="topoelementarray"/> from a set of <xref linkend="topoelement"/>.
uk: Використовується для створення <xref linkend="topoelementarray"/> з набору <xref linkend="topoelement"/>.

note: Tag: refpurpose
en: Converts a topogeometry to a topoelement.
uk: Перетворює топогеометрію в топоелемент.

note: Tag: para
en: Converts a <xref linkend="topogeometry"/> to a <xref linkend="topoelement"/>.
uk: Перетворює <xref linkend="topogeometry"/> на <xref linkend="topoelement"/>.

note: Tag: title
en: TopoGeometry Editors
uk: Редактори топогеометрії

note: Tag: para
en: This section covers the topology functions for editing existing topogeometries.
uk: Цей розділ охоплює функції топології для редагування існуючих топогеометрій.

note: Tag: refpurpose
en: Clears the content of a topo geometry.
uk: Очищає вміст геометрії топографії.

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.
uk: Очищає вміст <xref linkend="topogeometry"/>, перетворюючи його на порожній. Найчастіше використовується разом з <xref linkend="toTopoGeom"/> для заміни форми існуючих об'єктів та будь-яких залежних об'єктів на вищих ієрархічних рівнях.

note: Tag: para
en: Availability: 2.1
uk: Доступність: 2.1

note: Tag: refpurpose
en: Adds an element to the definition of a TopoGeometry.
uk: Додає елемент до визначення 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.
uk: Додає <xref linkend="topoelement"/> до визначення об'єкта TopoGeometry. Не видає помилку, якщо елемент вже є частиною визначення.

note: Tag: para
en: Availability: 2.3
uk: Доступність: 2.3

note: Tag: refpurpose
en: Removes an element from the definition of a TopoGeometry.
uk: Видаляє елемент з визначення TopoGeometry.

note: Tag: para
en: Removes a <xref linkend="topoelement"/> from the definition of a TopoGeometry object.
uk: Видаляє <xref linkend="topoelement"/> з визначення об'єкта TopoGeometry.

note: Tag: refpurpose
en: Adds element of a TopoGeometry to the definition of another TopoGeometry.
uk: Додає елемент 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.
uk: Додає елементи <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.
uk: Два об'єкти TopoGeometry повинні бути визначені відповідно до *однієї і тієї ж* топології, а якщо вони визначені ієрархічно, то повинні складатися з елементів одного і того ж дочірнього шару.

note: Tag: para
en: Availability: 3.2
uk: Доступність: 3.2

note: Tag: refpurpose
en: Adds a geometry shape to an existing topo geometry.
uk: Додає геометричну фігуру до існуючої топографічної геометрії.

note: Tag: para
en: Refer to <xref linkend="toTopoGeom"/>.
uk: Див. <xref linkend="toTopoGeom"/>.

note: Tag: title
en: TopoGeometry Accessors
uk: Доступ до топогеометрії

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).
uk: Повертає <varname>topoelementarray</varname> (масив топоелементів), що містить топологічні елементи та тип заданої TopoGeometry (примітивні елементи).

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.
uk: Повертає <xref linkend="topoelementarray"/>, що містить топологічні елементи та тип заданої TopoGeometry (примітивні елементи). Це схоже на 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.
uk: tg_id — ідентифікатор топогеометрії об'єкта топогеометрії в топології в шарі, позначеному <varname>layer_id</varname> в таблиці topology.layer.

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).
uk: Повертає набір об'єктів <varname>topoelement</varname>, що містять топологічні element_id,element_type заданої TopoGeometry (примітивні елементи).

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.
uk: Повертає набір element_id,element_type (topoelements), що відповідає елементам примітивної топології <xref linkend="topoelement"/> (1: вузли, 2: ребра, 3: грані), з яких складається заданий об'єкт топогеометрії в схемі <varname>toponame</varname>.

note: Tag: refpurpose
en: Returns the spatial reference identifier for a topogeometry.
uk: Повертає ідентифікатор просторової прив'язки для топогеометрії.

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"/>
uk: Повертає ідентифікатор просторової прив'язки для 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.
uk: Таблиця spatial_ref_sys — це таблиця, яка каталогізує всі системи просторових посилань, відомі PostGIS, і використовується для перетворення з однієї системи просторових посилань в іншу. Тому, якщо ви плануєте перетворювати геометрії, важливо перевірити, чи маєте ви правильний ідентифікатор системи просторових посилань.

note: Tag: title
en: TopoGeometry Outputs
uk: Вихідні дані TopoGeometry

note: Tag: refpurpose
en: Returns the GML representation of a topogeometry.
uk: Повертає 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.
uk: Повертає GML-представлення топогеометрії у форматі GML3. Якщо не вказано <varname>nsprefix_in</varname>, використовується <varname>gml</varname>. Передайте порожній рядок для nsprefix, щоб отримати некваліфікований простір імен. Параметри точності (за замовчуванням: 15) та опції (за замовчуванням 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:
uk: Параметр <varname>visitedTable</varname>, якщо він вказаний, використовується для відстеження відвіданих елементів Node та Edge, щоб використовувати перехресні посилання (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.
uk: Параметр <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.
uk: Параметр <varname>gmlver</varname>, якщо вказано, буде передано до базового ST_AsGML. За замовчуванням встановлено значення 3.

note: Tag: para
en: This uses the topo geometry we created in <xref linkend="CreateTopoGeom"/>
uk: Тут використовується геометрія топографії, яку ми створили в <xref linkend="CreateTopoGeom"/>

note: Tag: para
en: Same exercise as previous without namespace
uk: Те саме завдання, що й попереднє, але без простору імен

note: Tag: refpurpose
en: Returns the TopoJSON representation of a topogeometry.
uk: Повертає представлення топогеометрії у форматі 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.
uk: Повертає представлення топогеометрії у форматі TopoJSON. Якщо <varname>edgeMapTable</varname> не є нульовим, воно буде використовуватися як відображення ідентифікаторів ребер на індекси дуг для пошуку/зберігання. Це необхідно для того, щоб у кінцевому документі можна було отримати компактний масив "дуг".

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.
uk: У таблиці, якщо вона надана, має бути поле "arc_id" типу "serial" та "edge_id" типу integer; код буде запитувати таблицю щодо "edge_id", тому рекомендується додати індекс до цього поля.

note: Tag: para
en: Arc indices in the TopoJSON output are 0-based but they are 1-based in the "edgeMapTable" table.
uk: Індекси дуг у вихідних даних 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>.
uk: Повний документ TopoJSON повинен містити, крім фрагментів, повернутих цією функцією, фактичні дуги та деякі заголовки. Див. <link xlink:href="http://github.com/mbostock/topojson-specification/blob/master/README.md">специфікацію TopoJSON</link>.

note: Tag: para
en: Enhanced: 2.2.1 added support for puntal inputs
uk: Покращено: у версії 2.2.1 додано підтримку вхідних сигналів puntal

note: Tag: title
en: Topology Spatial Relationships
uk: Топологія Просторові відносини

note: Tag: para
en: This section lists the Topology functions used to check relationships between topogeometries and topology primitives
uk: У цьому розділі перелічено функції топології, що використовуються для перевірки взаємозв'язків між топогеометріями та топологічними примітивами

note: Tag: refpurpose
en: Returns true if two topogeometries are composed of the same topology primitives.
uk: Повертає true, якщо дві топогеометрії складаються з однакових топологічних примітивів.

note: Tag: para
en: Returns true if two topogeometries are composed of the same topology primitives: faces, edges, nodes.
uk: Повертає true, якщо дві топогеометрії складаються з однакових топологічних примітивів: граней, ребер, вузлів.

note: Tag: para
en: This function not supported for topogeometries that are geometry collections. It also can not compare topogeometries from different topologies.
uk: Ця функція не підтримується для топогеометрій, які є колекціями геометрій. Вона також не може порівнювати топогеометрії з різних топологій.

note: Tag: refpurpose
en: <refpurpose>Returns true if any pair of primitives from the two topogeometries intersect.</refpurpose>
uk: <refpurpose>Повертає true, якщо будь-яка пара примітивів з двох топогеометрій перетинаються.</refpurpose>

note: Tag: para
en: <para>Returns true if any pair of primitives from the two topogeometries intersect.</para>
uk: <para>Повертає 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).
uk: Ця функція не підтримується для топогеометрій, які є колекціями геометрій. Вона також не може порівнювати топогеометрії з різних топологій. Також наразі не підтримується для ієрархічних топогеометрій (топогеометрій, що складаються з інших топогеометрій).

note: Tag: title
en: Importing and exporting Topologies
uk: Імпорт та експорт топологій

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.
uk: Після створення топологій і, можливо, пов'язаних топологічних шарів, ви можете експортувати їх у файловий формат для резервного копіювання або перенесення в іншу базу даних.

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.
uk: Використання стандартних інструментів PostgreSQL для вивантаження/відновлення є проблематичним, оскільки топології складаються з набору таблиць (4 для примітивних типів, довільна кількість для шарів) та записів у таблицях метаданих (topology.topology та topology.layer). Крім того, ідентифікатори топології не є однозначними в різних базах даних, тому параметри топології потрібно буде змінити після її відновлення.

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:
uk: Для спрощення експорту/відновлення топологій надається пара виконуваних файлів: <filename>pgtopo_export</filename> та <filename>pgtopo_import</filename>. Приклад використання:

note: Tag: title
en: Using the Topology exporter
uk: Використання експорту топології

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.
uk: Скрипт <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.
uk: За замовчуванням <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.
uk: За замовчуванням <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.
uk: Виклик <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.
uk: Формат файлу дампа — це стиснений архів tar каталогу <filename>pgtopo_export</filename>, що містить принаймні файл <filename>pgtopo_dump_version</filename> з інформацією про версію формату. Починаючи з версії <code>1</code>, каталог містить CSV-файли, розділені табуляцією, з даними таблиць примітивних елементів топології (node, edge_data, face, relation), пов'язаними з ними записами топології та шарів, а також (якщо не вказано <code>--skip-layers</code>) дамп таблиць у форматі PostgreSQL, що повідомляються як шари заданої топології.

note: Tag: title
en: Using the Topology importer
uk: Використання імпортера топології

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.
uk: Скрипт <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.
uk: Створений файл 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.
uk: За замовчуванням <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.
uk: За замовчуванням <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).
uk: Це може бути небажаним або непрацюючим у випадку, якщо ваша цільова база даних вже містить таблиці з такими самими іменами, як і в дампі. У такому випадку ви можете попросити пропустити рівні за допомогою перемикача <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).
uk: SQL для завантаження та зв'язування шарів тільки з топологією з іменем можна створити за допомогою перемикача <code>--only-layers</code>. Це може бути корисно для завантаження шарів ПІСЛЯ вирішення конфліктів імен або для зв'язування шарів з іншою топологією (наприклад, простою версією вихідної топології).

note: Tag: para
en: If the target topology already exists and you want it dropped upfront you can pass the <code>--drop-topology</code> switch (since PostGIS-3.6.0).
uk: Якщо цільова топологія вже існує і ви хочете її видалити заздалегідь, ви можете передати параметр <code>--drop-topology</code> (починаючи з PostGIS-3.6.0).

note: Tag: title
en: PostGIS Installation
uk: Встановлення PostGIS

note: Tag: para
en: This chapter details the steps required to install PostGIS.
uk: У цьому розділі детально описано кроки, необхідні для встановлення PostGIS.

note: Tag: title
en: Short Version
uk: Коротка версія

note: Tag: para
en: To compile assuming you have all the dependencies in your search path:
uk: Щоб скомпілювати, припускаючи, що у вашому шляху пошуку є всі залежності:

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.
uk: Після встановлення PostGIS його потрібно ввімкнути (<xref linkend="create_spatial_db"/>) або оновити (<xref linkend="upgrading"/>) в кожній окремій базі даних, в якій ви хочете його використовувати.

note: Tag: title
en: Compiling and Install from Source
uk: Компіляція та встановлення з вихідного коду

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.
uk: Багато операційних систем зараз містять готові пакети для 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>.
uk: Цей розділ містить загальні інструкції з компіляції. Якщо ви компілюєте для Windows тощо або іншої ОС, додаткову детальну допомогу можна знайти за посиланням <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiInstall">Посібники з компіляції, надані користувачами PostGIS</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>
uk: Готові пакети для різних операційних систем перелічені в <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPackages">Готові пакети PostGIS</link>

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.
uk: Модуль PostGIS є розширенням серверного бекенду PostgreSQL. Як такий, PostGIS &last_release_version; <emphasis>вимагає</emphasis> повного доступу до заголовків сервера PostgreSQL для компіляції. Його можна скомпілювати для версій 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> .
uk: Якщо ви ще не встановили PostgreSQL, зверніться до інструкцій з інсталяції PostgreSQL. <link xlink:href="https://www.postgresql.org"> https://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:
uk: Для роботи GEOS, під час встановлення PostgreSQL може знадобитися явно пов'язати 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.
uk: Це обхідний шлях для вирішення проблеми взаємодії помилкових винятків 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.
uk: Наступні кроки описують конфігурацію та компіляцію вихідного коду PostGIS. Вони написані для користувачів Linux і не працюватимуть на Windows або Mac.

note: Tag: title
en: Getting the Source
uk: Отримання вихідного коду

note: Tag: para
en: Retrieve the PostGIS source archive from the downloads website <link xlink:href="&postgis_download_url;"> &postgis_download_url; </link>
uk: Завантажте архів PostGIS з веб-сайту завантажень <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.
uk: Це створить каталог з назвою <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> .
uk: Або перегляньте джерело з репозиторію <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.
uk: Перейдіть до новоствореного каталогу <varname>postgis</varname>, щоб продовжити встановлення.

note: Tag: title
en: Install Requirements
uk: Вимоги до встановлення

note: Tag: para
en: PostGIS has the following requirements for building and usage:
uk: PostGIS має наступні вимоги до побудови та використання:

note: Tag: emphasis
en: Required
uk: Необхідно

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>18 .
uk: PostgreSQL &min_postgres_version; - &max_postgres_version;. Потрібна повна інсталяція PostgreSQL (включно з заголовками сервера). PostgreSQL доступний за адресою <link xlink:href="https://www.postgresql.org"> https://www.postgresql.org </link>18 .

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>
uk: Повна матриця підтримки PostgreSQL / PostGIS та матриця підтримки PostGIS/GEOS наведена за посиланням <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">https://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>.
uk: Компілятор GNU C (<filename>gcc</filename>). Для компіляції PostGIS можна використовувати й інші компілятори ANSI C, але при компіляції за допомогою <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.
uk: 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> .
uk: Бібліотека перепроекції 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.14+ 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>.
uk: Бібліотека геометрії GEOS, версія &min_geos_version; або вище, але для повного використання всіх нових функцій і можливостей необхідна версія GEOS 3.14+. 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>.
uk: 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>.
uk: JSON-C, версія 0.9 або вище. JSON-C наразі використовується для імпорту GeoJSON за допомогою функції ST_GeomFromGeoJson. 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>.
uk: 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>.
uk: При компіляції з PostgreSQL+JIT необхідна версія LLVM &gt;=6 <link xlink:href="https://trac.osgeo.org/postgis/ticket/4125">https://trac.osgeo.org/postgis/ticket/4125</link>.

note: Tag: emphasis
en: Optional
uk: Додатково

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"/>.
uk: 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> .
uk: 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 2.1+ 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>.
uk: SFCGAL, 1.4.1 або вище, а для використання всіх функцій необхідна версія 2.1+. SFCGAL можна використовувати для надання додаткових функцій розширеного 2D- та 3D-аналізу для PostGIS cf <xref linkend="reference_sfcgal"/>. А також дозволяє використовувати SFCGAL замість GEOS для деяких 2D-функцій, що надаються обома бекендами (наприклад, ST_Intersection або ST_Area). Конфігураційна змінна 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 1 or 2 <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.
uk: Для побудови <xref linkend="Address_Standardizer"/> вам також знадобиться PCRE 1 або 2 <link xlink:href="http://www.pcre.org">http://www.pcre.org</link> (яка, як правило, вже встановлена в системах nix). <xref linkend="Address_Standardizer"/> буде створено автоматично, якщо буде виявлено бібліотеку PCRE, або якщо ви передасте дійсний <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.
uk: Щоб увімкнути ST_AsMVT, потрібна бібліотека protobuf-c 1.1.0 або вище (для використання) та компілятор protoc-c (для побудови). Також для перевірки мінімальної версії protobuf-c необхідний pkg-config. Див. <link xlink:href="https://github.com/protobuf-c/protobuf-c">protobuf-c</link>. За замовчуванням Postgis використовує Wagyu для швидшої перевірки полігонів MVT, що вимагає компілятора 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>
uk: 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> .
uk: Для створення документації необхідний DocBook (<filename>xsltproc</filename>). Docbook доступний за адресою <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> .
uk: DBLatex (<filename>dblatex</filename>) необхідний для створення документації у форматі PDF. DBLatex доступний за адресою <link xlink:href="http://dblatex.sourceforge.net/"> http://dblatex.sourceforge.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> .
uk: Для створення зображень, що використовуються в документації, необхідна програма ImageMagick (<filename>convert</filename>). ImageMagick доступна за адресою <link xlink:href="http://www.imagemagick.org/"> http://www.imagemagick.org/ </link> .

note: Tag: title
en: Build configuration
uk: Конфігурація збірки

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
uk: Як і в більшості випадків встановлення 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.
uk: Без додаткових параметрів ця команда спробує автоматично знайти необхідні компоненти та бібліотеки, потрібні для компіляції вихідного коду 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.
uk: У наведеному нижче списку вказані лише найчастіше використовувані параметри. Повний список можна отримати за допомогою параметрів <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.
uk: Починаючи з 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.
uk: Це місце, куди будуть встановлені виконувані файли завантажувача PostGIS та спільні бібліотеки. За замовчуванням це місце збігається з місцем встановлення 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.
uk: Цей параметр наразі не працює, оскільки пакет встановлюється лише в каталог інсталяції 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.
uk: PostgreSQL надає утиліту під назвою <command>pg_config</command> для увімкнення розширень, таких як PostGIS, для пошуку каталогу інсталяції PostgreSQL. Використовуйте цей параметр (<command>--with-pgconfig=/path/to/pg_config</command>), щоб вручну вказати конкретну інсталяцію PostgreSQL, на основі якої буде побудовано PostGIS.

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.
uk: GDAL, необхідна бібліотека, надає функціональність, необхідну для підтримки растрових даних <command>gdal-config</command>, щоб програмне забезпечення могло знайти каталог інсталяції GDAL. Використовуйте цей параметр (<command>--with-gdalconfig=/path/to/gdal-config</command>), щоб вручну вказати конкретну інсталяцію GDAL, на основі якої буде побудовано PostGIS.

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.
uk: GEOS, необхідна бібліотека геометрії, надає утиліту під назвою <command>geos-config</command> для того, щоб програмне забезпечення могло знайти каталог інсталяції GEOS. Використовуйте цей параметр (<command>--with-geosconfig=/path/to/geos-config</command>), щоб вручну вказати конкретну інсталяцію GEOS, на основі якої буде побудовано PostGIS.

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.
uk: LibXML — це бібліотека, необхідна для виконання процесів GeomFromKML/GML. Зазвичай вона знаходиться, якщо у вас встановлено libxml, але якщо її немає або ви хочете використовувати конкретну версію, вам потрібно вказати PostGIS на конкретний файл конфігурації <filename>xml2-config</filename>, щоб програмне забезпечення могло знайти каталог установки LibXML. Використовуйте цей параметр (<command>&gt;--with-xml2config=/path/to/xml2-config</command>), щоб вручну вказати конкретну інсталяцію LibXML, на основі якої буде побудовано PostGIS.

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.
uk: Proj — це бібліотека перепроекції, необхідна для PostGIS. Використовуйте цей параметр (<command>--with-projdir=/path/to/projdir</command>), щоб вручну вказати конкретний каталог інсталяції Proj, на основі якого буде побудовано PostGIS.

note: Tag: para
en: Directory where iconv is installed.
uk: Каталог, в якому встановлено 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.
uk: <link xlink:href="http://oss.metaparadigm.com/json-c/">JSON-C</link> — це бібліотека JSON з ліцензією MIT, необхідна для підтримки PostGIS ST_GeomFromJSON. Використовуйте цей параметр (<command>--with-jsondir=/path/to/jsondir</command>), щоб вручну вказати конкретний каталог інсталяції JSON-C, на основі якого буде побудовано PostGIS.

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.
uk: <link xlink:href="http://www.pcre.org/">PCRE</link> — це бібліотека регулярних виразів, сумісна з Perl, що має ліцензію BSD і потрібна для розширення address_standardizer. Використовуйте цей параметр (<command>--with-pcredir=/path/to/pcredir</command>), щоб вручну вказати конкретний каталог інсталяції PCRE, на основі якого буде побудовано PostGIS.

note: Tag: para
en: Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-gui graphical interface to shp2pgsql.
uk: Скомпілюйте графічний інтерфейс імпорту даних (потрібен GTK+2.0). Це створить графічний інтерфейс shp2pgsql-gui для shp2pgsql.

note: Tag: para
en: Compile without raster support.
uk: Скомпілюйте без підтримки растрових зображень.

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.
uk: Вимкнути підтримку топології. Відповідної бібліотеки немає, оскільки вся логіка, необхідна для топології, міститься в бібліотеці 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.
uk: За замовчуванням PostGIS спробує виявити підтримку 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.
uk: За замовчуванням PostGIS не встановлюється з підтримкою sfcgal без цього параметра. <varname>PATH</varname> — це необов'язковий аргумент, який дозволяє вказати альтернативний шлях до sfcgal-config.

note: Tag: para
en: Disable updating postgis_revision.h to match current HEAD of the git repository.
uk: Вимкнути оновлення postgis_revision.h, щоб відповідати поточній версії HEAD репозиторію git.

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
uk: Якщо ви отримали 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.
uk: Цей скрипт створить скрипт <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.
uk: Якщо ви отримали PostGIS у вигляді архіву tar, запускати <command>./autogen.sh</command> не потрібно, оскільки <command>configure</command> вже було згенеровано.

note: Tag: title
en: Building
uk: Збірка

note: Tag: para
en: Once the Makefile has been generated, building PostGIS is as simple as running
uk: Після створення Makefile, збірка PostGIS зводиться до виконання команди

note: Tag: para
en: The last line of the output should be "<code>PostGIS was built successfully. Ready to install.</code>"
uk: Останній рядок виводу повинен бути таким: "<code>PostGIS було успішно скомпільовано. Готово до встановлення.</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.
uk: Починаючи з PostGIS v1.4.0, всі функції мають коментарі, згенеровані з документації. Якщо ви бажаєте встановити ці коментарі у ваші просторові бази даних пізніше, запустіть команду, яка вимагає docbook. Файли postgis_comments.sql та інші файли коментарів пакету raster_comments.sql, topology_comments.sql також упаковані у tar.gz дистрибутив у папці doc, тому немає потреби створювати коментарі, якщо ви встановлюєте з tar-архіву. Коментарі також включені як частина інсталяції 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>
uk: Введено в PostGIS 2.0. Ця функція створює HTML-шпаргалки, які можна використовувати для швидкого довідкового пошуку або як роздатковий матеріал для студентів. Для створення потрібно xsltproc, після чого в папці doc буде створено 4 файли: <filename>topology_cheatsheet.html</filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, <filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet.html</filename>

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>
uk: Ви можете завантажити готові приклади у форматі html та pdf з <link xlink:href="http://www.postgis.us/study_guides">Посібників з PostGIS / PostgreSQL</link>

note: Tag: title
en: Building PostGIS Extensions and Deploying them
uk: Збірка розширень PostGIS та їх розгортання

note: Tag: para
en: The PostGIS extensions are built and installed automatically if you are using PostgreSQL 9.1+.
uk: Розширення PostGIS створюються та встановлюються автоматично, якщо ви використовуєте PostgreSQL 9.1+.

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:
uk: Якщо ви компілюєте з репозиторію вихідного коду, спочатку потрібно скомпілювати описи функцій. Вони компілюються, якщо у вас встановлено 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.
uk: Створювати коментарі не потрібно, якщо ви створюєте з архіву tar, оскільки вони вже попередньо вбудовані в архів tar.

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.
uk: Розширення повинні автоматично створюватися в рамках процесу make install. При необхідності ви можете створити їх з папок розширень або скопіювати файли, якщо вони потрібні вам на іншому сервері.

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>
uk: <code>make check</code> використовує psql для виконання тестів і, отже, може використовувати змінні середовища psql. Найпоширеніші змінні, які корисно замінити, — це <varname>PGUSER</varname>,<varname>PGPORT</varname> та <varname>PGHOST</varname>. Див. <link xlink:href="https://www.postgresql.org/docs/current/libpq-envars.html">Змінні середовища psql</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.
uk: Файли розширення завжди будуть однаковими для однієї версії PostGIS і PostgreSQL незалежно від ОС, тому можна копіювати файли розширення з однієї ОС на іншу, якщо на ваших серверах вже встановлено бінарні файли PostGIS.

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.
uk: Якщо ви хочете встановити розширення вручну на окремому сервері, відмінному від вашого сервера розробки, вам потрібно скопіювати наступні файли з папки розширень у папку <filename>PostgreSQL / share / extension</filename> вашої інсталяції PostgreSQL, а також необхідні бінарні файли для звичайного PostGIS, якщо вони ще не встановлені на сервері.

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>.
uk: Це контрольні файли, які містять таку інформацію, як версія розширення, яке потрібно встановити, якщо вона не вказана. <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>
uk: Усі файли в папці /sql кожного розширення. Зверніть увагу, що їх потрібно скопіювати в корінь папки PostgreSQL share/extension <filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/postgis_topology/sql/*.sql</filename>

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.
uk: Після цього ви повинні побачити <varname>postgis</varname>, <varname>postgis_topology</varname> як доступні розширення в PgAdmin -&gt; розширення.

note: Tag: para
en: If you are using psql, you can verify that the extensions are installed by running this query:
uk: Якщо ви використовуєте 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.
uk: Якщо розширення встановлено в базі даних, яку ви запитуєте, ви побачите згадку в стовпці <varname>installed_version</varname>. Якщо ви не отримали жодних записів, це означає, що на сервері взагалі не встановлено розширень postgis. 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:
uk: Якщо у вас доступні розширення, ви можете встановити розширення postgis у вибраній базі даних за допомогою інтерфейсу розширення pgAdmin або виконавши такі команди sql:

note: Tag: para
en: In psql you can use to see what versions you have installed and also what schema they are installed.
uk: У 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.
uk: Таблиці розширення <varname>spatial_ref_sys</varname>, <varname>layer</varname>, <varname>topology</varname> не можуть бути явно збережені. Їх можна створити резервну копію лише під час створення резервної копії відповідного розширення <varname>postgis</varname> або <varname>postgis_topology</varname>, що, як видається, відбувається лише під час створення резервної копії всієї бази даних. Починаючи з PostGIS 2.0.1, під час резервного копіювання бази даних створюються резервні копії лише записів 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.
uk: Якщо ви встановили &last_release_version; без використання нашої чудової системи розширень, ви можете змінити його на розширення, виконавши наведені нижче команди, щоб упакувати функції у відповідні розширення. Встановлення за допомогою `unpackaged` було видалено в PostgreSQL 13, тому перед оновленням до PostgreSQL 13 рекомендується перейти на збірку розширення.

note: Tag: title
en: Testing
uk: Тестування

note: Tag: para
en: If you wish to test the PostGIS build, run
uk: Якщо ви бажаєте протестувати збірку 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.
uk: Вищезазначена команда виконає різні перевірки та регресійні тести, використовуючи створену бібліотеку та реальну базу даних 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.
uk: Якщо ви налаштували PostGIS, використовуючи нестандартні розташування 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.
uk: Наразі команда <command>make check</command> під час виконання перевірок використовує змінні середовища <code>PATH</code> та <code>PGPORT</code> — вона <emphasis>не</emphasis> використовує версію PostgreSQL, яка може бути вказана за допомогою параметра конфігурації <command>--with-pgconfig</command>. Тому під час конфігурації обов'язково змініть 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):
uk: Якщо все пройде успішно, команда 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.
uk: Розширення <varname>postgis_tiger_geocoder</varname> та <varname>address_standardizer</varname> наразі підтримують лише стандартну перевірку інсталяції PostgreSQL. Щоб перевірити їх, скористайтеся наведеним нижче кодом. Примітка: команда make install не потрібна, якщо ви вже виконали make install у кореневому каталозі коду PostGIS.

note: Tag: para
en: For address_standardizer:
uk: Для address_standardizer:

note: Tag: para
en: Output should look like:
uk: Результат повинен виглядати так:

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:
uk: Для геокодера tiger переконайтеся, що у вашому екземплярі PostgreSQL доступні розширення postgis та fuzzystrmatch. Тести address_standardizer також запустяться, якщо ви створили postgis із підтримкою address_standardizer:

note: Tag: para
en: output should look like:
uk: результат повинен виглядати так:

note: Tag: title
en: Installation
uk: Встановлення

note: Tag: para
en: To install PostGIS, type
uk: Щоб встановити 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:
uk: Це скопіює файли інсталяції PostGIS у відповідний підкаталог, вказаний параметром конфігурації <command>--prefix</command>. Зокрема:

note: Tag: para
en: The loader and dumper binaries are installed in <filename>[prefix]/bin</filename>.
uk: Бінарні файли завантажувача та вивантажувача встановлюються в <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>.
uk: Файли SQL, такі як <filename>postgis.sql</filename>, встановлюються в <filename>[prefix]/share/contrib</filename>.

note: Tag: para
en: The PostGIS libraries are installed in <filename>[prefix]/lib</filename>.
uk: Бібліотеки 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
uk: Якщо ви раніше запустили команду <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>.
uk: <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
uk: Встановлення та використання стандартизатора адрес

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"/>.
uk: Розширення <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.
uk: Цей стандартизатор можна використовувати разом із розширенням PostGIS packaged tiger geocoder як заміну для <xref linkend="Normalize_Address"/>, про яке йшлося вище. Щоб використовувати його як заміну, зверніться до <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.
uk: Стандартизатор адрес використовує PCRE, який зазвичай вже встановлений на багатьох системах Nix, але ви можете завантажити останню версію за адресою: <link xlink:href="http://www.pcre.org">http://www.pcre.org</link>. Якщо під час <xref linkend="installation_configuration"/> буде знайдено PCRE, розширення стандартизатора адрес буде автоматично скомпільовано. Якщо ви хочете використовувати власну версію pcre, передайте в конфігурацію <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.
uk: Для користувачів Windows пакет PostGIS 2.1+ вже містить address_standardizer, тому компілювати не потрібно і можна переходити безпосередньо до кроку <code>CREATE EXTENSION</code>.

note: Tag: para
en: Once you have installed, you can connect to your database and run the SQL:
uk: Після встановлення ви можете підключитися до бази даних і запустити SQL:

note: Tag: para
en: The following test requires no rules, gaz, or lex tables
uk: Наступний тест не вимагає правил, газів або лексичних таблиць

note: Tag: para
en: Output should be
uk: Результат повинен бути таким

note: Tag: title
en: Installing, Upgrading Tiger Geocoder, and loading data
uk: Встановлення, оновлення Tiger Geocoder та завантаження даних

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.
uk: Додаткові компоненти, такі як геокодер Tiger, можуть не входити до складу вашого дистрибутива PostGIS. Якщо вам бракує розширення tiger geocoder або ви хочете мати новішу версію, ніж та, що входить до вашої інсталяції, скористайтеся файлами <filename>share/extension/postgis_tiger_geocoder.*</filename> з пакетів у розділі <link xlink:href="http://postgis.net/windows_downloads/">Windows Unreleased Versions</link> для вашої версії PostgreSQL. Хоча ці пакети призначені для Windows, файли розширення postgis_tiger_geocoder працюватимуть на будь-якій ОС, оскільки розширення є розширенням тільки для SQL/plpgsql.

note: Tag: title
en: Tiger Geocoder Enabling your PostGIS database
uk: Tiger Geocoder Увімкнення бази даних PostGIS

note: Tag: para
en: These directions assume your PostgreSQL installation already has the postgis_tiger_geocoder extension installed.
uk: Ці вказівки передбачають, що у вашій установці 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.
uk: Підключіться до бази даних за допомогою 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:
uk: Якщо ви вже встановили розширення 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.
uk: Якщо ви зробили власні записи або змінили <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:
uk: Щоб переконатися, що інсталяція працює правильно, виконайте цей sql-запит у вашій базі даних:

note: Tag: para
en: Which should output
uk: Що повинно вивести

note: Tag: para
en: Create a new record in <varname>tiger.loader_platform</varname> table with the paths of your executables and server.
uk: Створіть новий запис у таблиці <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:
uk: Наприклад, щоб створити профіль під назвою debbie, який дотримується конвенції <code>sh</code>, потрібно зробити наступне:

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.
uk: А потім відредагуйте шляхи в стовпці <emphasis>declare_sect</emphasis> відповідно до шляхів, що відповідають розташуванню pg, unzip, shp2pgsql, psql тощо у Debbie.

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.
uk: Якщо ви не відредагуєте цю таблицю <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.
uk: Починаючи з PostGIS 2.4.1, крок завантаження 5-значного поштового індексу <varname>zcta5</varname> було переглянуто, щоб завантажувати поточні дані zcta5, і він є частиною <xref linkend="Loader_Generate_Nation_Script"/>, коли ввімкнено. За замовчуванням він вимкнений, оскільки завантаження займає досить багато часу (від 20 до 60 хвилин), займає чимало місця на диску і використовується не так часто.

note: Tag: para
en: To enable it, do the following:
uk: Щоб увімкнути цю функцію, виконайте такі дії:

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.
uk: Якщо присутня функція <xref linkend="Geocode"/>, вона може використовувати її, якщо додано фільтр меж, щоб обмежити пошук лише поштовими індексами в цих межах. Функція <xref linkend="Reverse_Geocode"/> використовує її, якщо у повернутій адресі відсутній поштовий індекс, що часто трапляється при зворотному геокодуванні автомагістралей.

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.
uk: Створіть папку з назвою <filename>gisdata</filename> в кореневому каталозі сервера або на вашому локальному комп'ютері, якщо у вас швидке підключення до сервера. У цю папку будуть завантажуватися та оброблятися файли tiger. Якщо ви не хочете, щоб папка знаходилася в кореневому каталозі сервера, або просто хочете змінити папку для тимчасового зберігання, відредагуйте поле <varname>staging_fold</varname> в таблиці <varname>tiger.loader_variables</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.
uk: Створіть папку з назвою temp у папці <filename>gisdata</filename> або в будь-якому іншому місці, яке ви призначили для <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:
uk: Потім запустіть функцію SQL <xref linkend="Loader_Generate_Nation_Script"/>, обов'язково вкажіть ім'я вашого власного профілю та скопіюйте скрипт у файл .sh або .bat. Наприклад, щоб створити націю, завантажте:

note: Tag: para
en: Run the generated nation load commandline scripts.
uk: Запустіть скрипти командного рядка для завантаження нації, що були створені.

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
uk: Після завершення виконання скрипта nation у схемі <code>tiger_data</code> має бути три таблиці, які повинні бути заповнені даними. Перевірте це, виконавши наступні запити з psql або pgAdmin

note: Tag: para
en: This will only have data if you marked zcta5 to be loaded
uk: Це буде містити дані тільки в тому випадку, якщо ви позначили 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.
uk: За замовчуванням таблиці, що відповідають <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"/>
uk: Або ви можете завантажити тільки ці таблиці після завантаження даних про стан за допомогою <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.
uk: НЕ створюйте скрипт штату, поки не завантажили дані про країну, оскільки скрипт штату використовує список округів, завантажений скриптом країни.

note: Tag: para
en: For each state you want to load data for, generate a state script <xref linkend="Loader_Generate_Script"/>.
uk: Для кожного стану, для якого ви хочете завантажити дані, створіть скрипт стану <xref linkend="Loader_Generate_Script"/>.

note: Tag: para
en: Run the generated commandline scripts.
uk: Запустіть скрипти командного рядка, що були створені.

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)
uk: Після завантаження всіх даних або на етапі зупинки рекомендується проаналізувати всі таблиці tiger, щоб оновити статистику (включно зі статистикою, що успадковується)

note: Tag: title
en: Using Address Standardizer Extension with Tiger geocoder
uk: Використання розширення Address Standardizer з геокодером Tiger

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.
uk: Однією з багатьох скарг користувачів є функція нормалізації адреси <xref linkend="Normalize_Address"/>, яка нормалізує адресу для підготовки до геокодування. Нормалізатор далеко не ідеальний, і спроби виправити його недоліки вимагають значних ресурсів. Тому ми інтегрували інший проект, який має набагато кращий механізм стандартизації адрес. Щоб використовувати цей новий address_standardizer, скомпілюйте розширення, як описано в <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.
uk: Після встановлення цього розширення в тій самій базі даних, де встановлено <code>postgis_tiger_geocoder</code>, замість <xref linkend="Normalize_Address"/> можна використовувати <xref linkend="Pagc_Normalize_Address"/>. Це розширення не залежить від tiger, тому його можна використовувати з іншими джерелами даних, такими як міжнародні адреси. Розширення tiger geocoder постачається у комплекті з власними версіями <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
uk: Необхідні інструменти для завантаження 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.
uk: Процес завантаження завантажує дані з веб-сайту перепису населення для відповідних файлів країн, запитуваних штатів, витягує файли, а потім завантажує кожен штат у свій окремий набір таблиць штатів. Кожна таблиця штату успадковує таблиці, визначені в схемі <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:
uk: Для завантаження даних вам знадобляться такі інструменти:

note: Tag: para
en: A tool to unzip the zip files from census website.
uk: Інструмент для розпакування zip-файлів з веб-сайту перепису населення.

note: Tag: para
en: For Unix like systems: <varname>unzip</varname> executable which is usually already installed on most Unix like platforms.
uk: Для систем типу 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>
uk: Для 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.
uk: Командний рядок <filename>shp2pgsql</filename>, який встановлюється за замовчуванням під час інсталяції PostGIS.

note: Tag: para
en: <filename>wget</filename> which is a web grabber tool usually installed on most Unix/Linux systems.
uk: <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>
uk: Якщо ви використовуєте 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.
uk: Якщо ви оновлюєте систему з tiger_2010, спочатку потрібно створити та запустити <xref linkend="Drop_Nation_Tables_Generate_Script"/>. Перед завантаженням будь-яких даних про стан, потрібно завантажити загальнонаціональні дані за допомогою <xref linkend="Loader_Generate_Nation_Script"/>. Це створить для вас скрипт завантажувача. <xref linkend="Loader_Generate_Nation_Script"/> — це одноразовий крок, який потрібно виконати для оновлення (з даних перепису тигрів за попередній рік) та для нових інсталяцій.

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.
uk: Щоб завантажити дані про стан, зверніться до <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"/>.
uk: Після завантаження потрібних штатів обов'язково виконайте команду: <programlisting>SELECT install_missing_indexes();</programlisting> відповідно до опису в <xref linkend="Install_Missing_Indexes"/>.

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"/>
uk: Щоб перевірити, чи все працює як слід, спробуйте виконати геокодування адреси у вашому штаті, використовуючи <xref linkend="Geocode"/>

note: Tag: title
en: Upgrading your Tiger Geocoder Install and Data
uk: Оновлення інсталяції та даних Tiger Geocoder

note: Tag: para
en: First upgrade your postgis_tiger_geocoder extension as follows:
uk: Спочатку оновіть розширення 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"/>
uk: Далі видаліть усі таблиці країн і завантажте нові. Створіть скрипт видалення за допомогою цього SQL-запиту, як описано в <xref linkend="Drop_Nation_Tables_Generate_Script"/>

note: Tag: para
en: Run the generated drop SQL statements.
uk: Виконайте згенеровані оператори SQL для створення таблиць.

note: Tag: para
en: Generate a nation load script with this SELECT statement as detailed in <xref linkend="Loader_Generate_Nation_Script"/>
uk: Створіть скрипт завантаження нації за допомогою цієї команди SELECT, як описано в <xref linkend="Loader_Generate_Nation_Script"/>

note: Tag: emphasis
en: For windows
uk: Для windows

note: Tag: emphasis
en: For unix/linux
uk: Для 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.
uk: Інструкції щодо запуску скрипту генерації див. у <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"/>.
uk: Ви можете мати комбінацію таблиць стану за різні роки та оновлювати кожен стан окремо. Перед оновленням стану спочатку потрібно видалити таблиці стану за попередній рік для цього стану за допомогою <xref linkend="Drop_State_Tables_Generate_Script"/>.

note: Tag: title
en: Common Problems during installation
uk: Поширені проблеми під час встановлення

note: Tag: para
en: There are several things to check when your installation or upgrade doesn't go as you expected.
uk: Якщо установка або оновлення не відбуваються так, як ви очікували, слід перевірити кілька речей.

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:
uk: Переконайтеся, що ви встановили PostgreSQL &min_postgres_version; або новішу версію, і що ви компілюєте з тією ж версією вихідного коду PostgreSQL, що і версія 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>
uk: Якщо ви використовуєте дистрибутив на основі 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.
uk: Якщо оновлення не вдалося, переконайтеся, що ви відновлюєте дані в базу, в якій вже встановлено 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.
uk: Також перевірте, чи конфігуратор правильно визначив розташування та версію PostgreSQL, бібліотеки Proj та бібліотеки 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.
uk: Вихідні дані команди configure використовуються для створення файлу <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
uk: Вступ

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.
uk: PostGIS — це просторове розширення для реляційної бази даних PostgreSQL, створене компанією Refractions Research Inc. як проект з дослідження технологій просторових баз даних. Refractions — це компанія з консалтингу в галузі ГІС та баз даних, розташована у місті Вікторія, Британська Колумбія, Канада, що спеціалізується на інтеграції даних та розробці програмного забезпечення на замовлення.

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.
uk: PostGIS зараз є проєктом Фонду OSGeo, розробляється і фінансується багатьма розробниками FOSS4G і організаціями по всьому світу, які отримують величезну користь від його функціональності та універсальності.

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.
uk: Група розробників проєкту PostGIS планує підтримувати та вдосконалювати PostGIS для кращої підтримки ряду важливих функціональних можливостей ГІС в області просторових стандартів OGC і SQL/MM, розширених топологічних конструкцій (покриття, поверхні, сітки), джерел даних для інструментів для перегляду і редагування даних ГІС, а також інструментів вебдоступу до них.

note: Tag: title
en: Project Steering Committee
uk: Керівний комітет проекту

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.
uk: Координаційний комітет проекту PostGIS (PSC) координує загальний напрямок, цикли випуску, документацію та інформаційно-просвітницьку діяльність проекту PostGIS. Крім того, PSC надає загальну підтримку користувачам, приймає та затверджує виправлення від загальної спільноти PostGIS і голосує з різних питань, що стосуються PostGIS, таких як доступ розробників до комітів, нові члени PSC або значні зміни API.

note: Tag: term
en: Raúl Marín Rodríguez
uk: Рауль Марін Родрігес

note: Tag: para
en: MVT support, Bug fixing, Performance and stability improvements, GitHub curation, alignment of PostGIS with PostgreSQL releases
uk: Підтримка MVT, виправлення помилок, поліпшення продуктивності та стабільності, курація GitHub, узгодження PostGIS з релізами PostgreSQL

note: Tag: term
en: Regina Obe
uk: Регіна Обе

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.
uk: CI та обслуговування веб-сайту, виробництво та експериментальні збірки Windows, документація, узгодження PostGIS з випусками PostgreSQL, підтримка X3D, підтримка геокодера TIGER, функції управління.

note: Tag: term
en: Darafei Praliaskouski
uk: Дарафей Пралясковський

note: Tag: para
en: Index improvements, bug fixing and geometry/geography function improvements, SFCGAL, raster, GitHub curation, and ci maintenance.
uk: Покращення індексу, виправлення помилок та покращення функцій геометрії/географії, SFCGAL, растр, курація GitHub та обслуговування ci.

note: Tag: term
en: Paul Ramsey (Chair)
uk: Пол Рамзі (голова)

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.
uk: Співзасновник проекту PostGIS. Загальне виправлення помилок, підтримка географії, підтримка географічних та геометричних індексів (2D, 3D, nD індекси та будь-які просторові індекси), внутрішні структури геометрії, інтеграція функціональності GEOS та узгодження з релізами GEOS, узгодження PostGIS з релізами PostgreSQL, завантажувач/вивантажувач та завантажувач Shapefile GUI.

note: Tag: term
en: Sandro Santilli
uk: Сандро Сантіллі

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.
uk: Виправлення помилок та технічне обслуговування, обслуговування CI, управління дзеркалами Git, функції управління, інтеграція нових функцій GEOS та узгодження з випусками GEOS, підтримка топології, а також функції растрової структури та API низького рівня.

note: Tag: title
en: Core Contributors Present
uk: Основні учасники

note: Tag: term
en: Nicklas Avén
uk: Ніклас Авен

note: Tag: para
en: Distance function enhancements (including 3D distance and relationship functions) and additions, Tiny WKB (TWKB) output format and general user support
uk: Покращення функції відстані (включно з функціями 3D-відстані та взаємозв'язку) та доповнення, формат виводу Tiny WKB (TWKB) та загальна підтримка користувачів

note: Tag: term
en: Loïc Bartoletti
uk: Лоїк Бартолетті

note: Tag: para
en: SFCGAL enhancements and maintenance and ci support
uk: Покращення та обслуговування SFCGAL і підтримка ci

note: Tag: term
en: Dan Baston
uk: Ден Бастон

note: Tag: para
en: Geometry clustering function additions, other geometry algorithm enhancements, GEOS enhancements and general user support
uk: Додавання функцій кластеризації геометрії, інші вдосконалення алгоритмів геометрії, вдосконалення GEOS та загальна підтримка користувачів

note: Tag: term
en: Martin Davis
uk: Мартін Девіс

note: Tag: para
en: GEOS enhancements and documentation
uk: Удосконалення та документація GEOS

note: Tag: term
en: Björn Harrtell
uk: Бйорн Харрелл

note: Tag: para
en: MapBox Vector Tile, GeoBuf, and Flatgeobuf functions. Gitea testing and GitLab experimentation.
uk: Функції MapBox Vector Tile, GeoBuf та Flatgeobuf. Тестування Gitea та експерименти GitLab.

note: Tag: term
en: Aliaksandr Kalenik
uk: Олександр Каленік

note: Tag: para
en: Geometry Processing, PostgreSQL gist, general bug fixing
uk: Обробка геометрії, PostgreSQL gist, загальне виправлення помилок

note: Tag: title
en: Core Contributors Past
uk: Основні учасники минулого

note: Tag: term
en: Bborie Park
uk: Бборі Парк

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)
uk: Колишній член PSC. Розробка растрових даних, інтеграція з GDAL, завантажувач растрових даних, підтримка користувачів, загальне виправлення помилок, тестування на різних ОС (Slackware, Mac, Windows та інші)

note: Tag: term
en: Mark Cave-Ayland
uk: Марк Кейв-Айланд

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.
uk: Колишній член PSC. Координація виправлення помилок та технічного обслуговування, вибірковості та прив'язки просторового індексу, завантажувача/вивантажувача, а також Shapefile GUI Loader, інтеграція нових та вдосконалених функцій.

note: Tag: term
en: Jorge Arévalo
uk: Хорхе Аревало

note: Tag: para
en: Raster development, GDAL driver support, loader
uk: Розробка растрових даних, підтримка драйвера GDAL, завантажувач

note: Tag: term
en: Olivier Courtin
uk: Олів'є Куртен

note: Tag: para
en: (Emeritus) Input/output XML (KML,GML)/GeoJSON functions, 3D support and bug fixes.
uk: (Почесний) Функції введення/виведення XML (KML, GML)/GeoJSON, підтримка 3D та виправлення помилок.

note: Tag: term
en: Chris Hodgson
uk: Кріс Ходжсон

note: Tag: para
en: Prior PSC Member. General development, site and buildbot maintenance, OSGeo incubation management
uk: Колишній член PSC. Загальний розвиток, обслуговування сайту та buildbot, управління інкубацією OSGeo

note: Tag: term
en: Mateusz Loskot
uk: Матеуш Лоскот

note: Tag: para
en: CMake support for PostGIS, built original raster loader in python and low level raster API functions
uk: Підтримка CMake для PostGIS, вбудований оригінальний завантажувач растрових даних на Python та функції низького рівня для роботи з растровими даними

note: Tag: term
en: Kevin Neufeld
uk: Кевін Нойфельд

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.
uk: Колишній член PSC. Документація та інструменти підтримки документації, обслуговування buildbot, підтримка досвідчених користувачів у новинній групі PostGIS та вдосконалення функцій обслуговування PostGIS.

note: Tag: term
en: Dave Blasby
uk: Дейв Бласбі

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.
uk: Оригінальний розробник/співзасновник PostGIS. Дейв написав об'єкти серверної частини, індексні прив'язки та багато аналітичних функцій серверної частини.

note: Tag: term
en: Jeff Lounsbury
uk: Джефф Лаунсбері

note: Tag: para
en: Original development of the Shapefile loader/dumper.
uk: Оригінальна розробка завантажувача/вивантажувача Shapefile.

note: Tag: term
en: Mark Leslie
uk: Марк Леслі

note: Tag: para
en: Ongoing maintenance and development of core functions. Enhanced curve support. Shapefile GUI loader.
uk: Постійне обслуговування та розвиток основних функцій. Покращена підтримка кривих. Завантажувач Shapefile GUI.

note: Tag: term
en: Pierre Racine
uk: П'єр Расін

note: Tag: para
en: Architect of PostGIS raster implementation. Raster overall architecture, prototyping, programming support
uk: Архітектор реалізації растрових даних PostGIS. Загальна архітектура растрових даних, прототипування, підтримка програмування

note: Tag: term
en: David Zwarg
uk: Девід Цварг

note: Tag: para
en: Raster development (mostly map algebra analytic functions)
uk: Розробка растрових даних (переважно аналітичні функції алгебри карт)

note: Tag: title
en: Other Contributors
uk: Інші автори

note: Tag: term
en: Individual Contributors
uk: Індивідуальні учасники

note: Tag: member
en: Alex Bodnaru
uk: Алекс Боднару

note: Tag: member
en: Alex Mayrhofer
uk: Алекс Майрхофер

note: Tag: member
en: Andrea Peri
uk: Андреа Пері

note: Tag: member
en: Andreas Forø Tollefsen
uk: Андреас Форо Толлефсен

note: Tag: member
en: Andreas Neumann
uk: Андреас Нойман

note: Tag: member
en: Andrew Gierth
uk: Ендрю Герт

note: Tag: member
en: Anne Ghisla
uk: Енн Гісла

note: Tag: member
en: Antoine Bajolet
uk: Антуан Бажоле

note: Tag: member
en: Arthur Lesuisse
uk: Артур Лесуа

note: Tag: member
en: Artur Zakirov
uk: Артур Закіров

note: Tag: member
en: Ayo Adesugba
uk: Айо Адесугба

note: Tag: member
en: Barbara Phillipot
uk: Барбара Філліпот

note: Tag: member
en: Ben Jubb
uk: Бен Джубб

note: Tag: member
en: Bernhard Reiter
uk: Бернхард Райтер

note: Tag: member
en: Björn Esser
uk: Бйорн Ессер

note: Tag: member
en: Brian Hamlin
uk: Брайан Хемлін

note: Tag: member
en: Bruce Rindahl
uk: Брюс Ріндал

note: Tag: member
en: Bruno Wolff III
uk: Бруно Вольф III

note: Tag: member
en: Bryce L. Nordgren
uk: Брайс Л. Нордгрен

note: Tag: member
en: Carl Anderson
uk: Карл Андерсон

note: Tag: member
en: Charlie Savage
uk: Чарлі Сейвідж

note: Tag: member
en: Chris Mayo
uk: Кріс Майо

note: Tag: member
en: Christian Schroeder
uk: Крістіан Шредер

note: Tag: member
en: Christoph Berg
uk: Крістоф Берг

note: Tag: member
en: Christoph Moench-Tegeder
uk: Крістоф Менх-Тегедер

note: Tag: member
en: Dane Springmeyer
uk: Дейн Спрінгмейер

note: Tag: member
en: Daniel Nylander
uk: Даніель Нюландер

note: Tag: member
en: Dapeng Wang
uk: Дапен Ван

note: Tag: member
en: Daryl Herzmann
uk: Деріл Герцманн

note: Tag: member
en: Dave Fuhry
uk: Дейв Фурі

note: Tag: member
en: David Garnier
uk: Девід Гарньє

note: Tag: member
en: David Skea
uk: Девід Скі

note: Tag: member
en: David Techer
uk: Девід Течер

note: Tag: member
en: Dian M Fay
uk: Діан М. Фей

note: Tag: member
en: Dmitry Vasilyev
uk: Дмитро Василєв

note: Tag: member
en: Eduin Carrillo
uk: Едуїн Каррільо

note: Tag: member
en: Esteban Zimanyi
uk: Естебан Зімані

note: Tag: member
en: Eugene Antimirov
uk: Євген Антиміров

note: Tag: member
en: Even Rouault
uk: Навіть Руо

note: Tag: member
en: Florian Weimer
uk: Флоріан Ваймер

note: Tag: member
en: Frank Warmerdam
uk: Френк Вармердам

note: Tag: member
en: George Silva
uk: Джордж Сільва

note: Tag: member
en: Gerald Fenoy
uk: Джеральд Феной

note: Tag: member
en: Gino Lucrezi
uk: Джино Лукрезі

note: Tag: member
en: Greg Troxel
uk: Грег Троксел

note: Tag: member
en: Guillaume Lelarge
uk: Гійом Леларж

note: Tag: member
en: Giuseppe Broccolo
uk: Джузеппе Брокколо

note: Tag: member
en: Han Wang
uk: Хан Ван

note: Tag: member
en: Hans Lemuet
uk: Ганс Лемует

note: Tag: member
en: Haribabu Kommi
uk: Харібабу Коммі

note: Tag: member
en: Havard Tveite
uk: Хавард Твейте

note: Tag: member
en: IIDA Tetsushi
uk: ІІДА Тетсуші

note: Tag: member
en: Ingvild Nystuen
uk: Інгвільд Нюстен

note: Tag: member
en: Jackie Leng
uk: Джекі Ленг

note: Tag: member
en: James Addison
uk: Джеймс Аддісон

note: Tag: member
en: James Marca
uk: Джеймс Марка

note: Tag: member
en: Jan Katins
uk: Ян Катінс

note: Tag: member
en: Jan Tojnar
uk: Ян Тожнар

note: Tag: member
en: Jason Smith
uk: Джейсон Сміт

note: Tag: member
en: Jeff Adams
uk: Джефф Адамс

note: Tag: member
en: Jelte Fennema
uk: Джелте Феннема

note: Tag: member
en: Jim Jones
uk: Джим Джонс

note: Tag: member
en: Joe Conway
uk: Джо Конвей

note: Tag: member
en: Jonne Savolainen
uk: Йонне Саволайнен

note: Tag: member
en: Jose Carlos Martinez Llari
uk: Хосе Карлос Мартінес Лларі

note: Tag: member
en: Jörg Habenicht
uk: Йорг Хабеніхт

note: Tag: member
en: Julien Rouhaud
uk: Жюльєн Руо

note: Tag: member
en: Kashif Rasul
uk: Кашиф Расул

note: Tag: member
en: Klaus Foerster
uk: Клаус Ферстер

note: Tag: member
en: Kris Jurka
uk: Кріс Юрка

note: Tag: member
en: Laurențiu Nicola
uk: Лаурентіу Нікола

note: Tag: member
en: Laurenz Albe
uk: Лауренц Альбе

note: Tag: member
en: Lars Roessiger
uk: Ларс Роессігер

note: Tag: member
en: Leo Hsu
uk: Лео Хсу

note: Tag: member
en: Loic Dachary
uk: Лоїк Дачарі

note: Tag: member
en: Luca S. Percich
uk: Лука С. Перчіч

note: Tag: member
en: Lucas C. Villa Real
uk: Лукас С. Вілла Реаль

note: Tag: member
en: Maksim Korotkov
uk: Максим Коротков

note: Tag: member
en: Maria Arias de Reyna
uk: Марія Аріас де Рейна

note: Tag: member
en: Marc Ducobu
uk: Марк Дюкубу

note: Tag: member
en: Mark Sondheim
uk: Марк Сондхайм

note: Tag: member
en: Markus Schaber
uk: Маркус Шабер

note: Tag: member
en: Markus Wanner
uk: Маркус Ваннер

note: Tag: member
en: Matt Amos
uk: Метт Амос

note: Tag: member
en: Matt Bretl
uk: Метт Бретл

note: Tag: member
en: Matthias Bay
uk: Матіас Бей

note: Tag: member
en: Maxime Guillaud
uk: Максим Гійо

note: Tag: member
en: Maxime van Noppen
uk: Максима ван Ноппен

note: Tag: member
en: Maxime Schoemans
uk: Максим Шеманс

note: Tag: member
en: Megan Ma
uk: Меган Ма

note: Tag: member
en: Michael Fuhr
uk: Майкл Фур

note: Tag: member
en: Mike Toews
uk: Майк Тоус

note: Tag: member
en: Nathan Wagner
uk: Натан Вагнер

note: Tag: member
en: Nathaniel Clay
uk: Натаніель Клей

note: Tag: member
en: Nikita Shulga
uk: Микита Шульга

note: Tag: member
en: Norman Vine
uk: Норман Вайн

note: Tag: member
en: Patricia Tozer
uk: Патрісія Тозер

note: Tag: member
en: Rafal Magda
uk: Рафал Магда

note: Tag: member
en: Ralph Mason
uk: Ральф Мейсон

note: Tag: member
en: Rémi Cura
uk: Ремі Кура

note: Tag: member
en: Richard Greenwood
uk: Річард Грінвуд

note: Tag: member
en: Robert Coup
uk: Роберт Куп

note: Tag: member
en: Roger Crew
uk: Роджер Крю

note: Tag: member
en: Ron Mayer
uk: Рон Майер

note: Tag: member
en: Sam Peters
uk: Сем Пітерс

note: Tag: member
en: Sebastiaan Couwenberg
uk: Себастьян Коувенберг

note: Tag: member
en: Sergei Shoulbakov
uk: Сергій Шульбаков

note: Tag: member
en: Sergey Fedoseev
uk: Сергій Федосєєв

note: Tag: member
en: Shinichi Sugiyama
uk: Шінічі Сугіяма

note: Tag: member
en: Shoaib Burq
uk: Шоаїб Бурк

note: Tag: member
en: Silvio Grosso
uk: Сільвіо Гроссо

note: Tag: member
en: Stefan Corneliu Petrea
uk: Стефан Корнеліу Петреа

note: Tag: member
en: Steffen Macke
uk: Стеффен Макке

note: Tag: member
en: Stepan Kuzmin
uk: Степан Кузьмін

note: Tag: member
en: Stephen Frost
uk: Стівен Фрост

note: Tag: member
en: Steven Ottens
uk: Стівен Оттенс

note: Tag: member
en: Talha Rizwan
uk: Талха Різван

note: Tag: member
en: Teramoto Ikuhiro
uk: Терамото Ікухіро

note: Tag: member
en: Tom Glancy
uk: Том Гленсі

note: Tag: member
en: Tom van Tilburg
uk: Том ван Тільбург

note: Tag: member
en: Victor Collod
uk: Віктор Колод

note: Tag: member
en: Vincent Bre
uk: Вінсент Бре

note: Tag: member
en: Vincent Mora
uk: Вінсент Мора

note: Tag: member
en: Vincent Picavet
uk: Вінсент Пікаве

note: Tag: member
en: Volf Tomáš
uk: Вольф Томаш

note: Tag: member
en: Zuo Chenwei
uk: Зуо Ченвей

note: Tag: term
en: Corporate Sponsors
uk: Корпоративні спонсори

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:
uk: Це корпоративні організації, які надали розробникам час, хостинг або пряме фінансове фінансування для проекту PostGIS. У алфавітному порядку:

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.
uk: Кампанії з краудфандингу — це кампанії, які ми проводимо, щоб зібрати кошти на реалізацію дуже потрібних функцій, які можуть бути корисними для великої кількості людей. Кожна кампанія зосереджена на конкретній функції або наборі функцій. Кожен спонсор вносить невелику частину необхідних коштів, і за умови, що достатня кількість людей/організацій долучиться до кампанії, ми отримаємо кошти для оплати роботи, яка допоможе багатьом. Якщо у вас є ідея щодо функції, яку, на вашу думку, багато інших людей були б готові спільно фінансувати, будь ласка, опублікуйте її в <link xlink:href="https://lists.osgeo.org/mailman/listinfo/postgis-users">групі новин PostGIS</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.
uk: PostGIS 2.0.0 був першим випуском, в якому ми випробували цю стратегію. Ми використовували <link xlink:href="http://www.pledgebank.com">PledgeBank</link> і провели дві успішні кампанії.

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.
uk: <link xlink:href="http://www.pledgebank.com/postgistopology"><emphasis role="bold">postgistopology</emphasis></link> - 10 спонсорів внесли по 250 доларів США на створення функції toTopoGeometry та покращення підтримки топології в версії 2.0.0. Це сталося.

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.
uk: <link xlink:href="http://www.pledgebank.com/postgis64windows"><emphasis role="bold">postgis64windows</emphasis></link> - 20 спонсорів внесли по 100 доларів США для оплати робіт, необхідних для вирішення проблем PostGIS 64-bit на Windows. Це сталося.

note: Tag: term
en: Important Support Libraries
uk: Важливі допоміжні бібліотеки

note: Tag: para
en: The <link xlink:href="https://libgeos.org">GEOS</link> geometry operations library
uk: Бібліотека геометричних операцій <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.
uk: Бібліотека абстракції геопросторових даних <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
uk: Бібліотека картографічних проекцій <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.
uk: І останнє, але не менш важливе, <link xlink:href="http://www.postgresql.org">PostgreSQL</link>, гігант, на якому стоїть PostGIS. Більша частина швидкості та гнучкості PostGIS була б неможливою без розширюваності, чудового планувальника запитів, індексу GIST та безлічі функцій SQL, що надаються PostgreSQL.

note: Tag: title
en: Performance Tips
uk: Поради щодо продуктивності

note: Tag: title
en: Small tables of large geometries
uk: Невеликі таблиці великих геометрій

note: Tag: title
en: Problem description
uk: Опис проблеми

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).
uk: Поточні версії PostgreSQL (включно з 9.6) мають недолік оптимізатора запитів щодо таблиць TOAST. Таблиці TOAST — це свого роду "розширення", що використовуються для зберігання великих (у сенсі розміру даних) значень, які не вміщуються на звичайних сторінках даних (наприклад, довгі тексти, зображення або складні геометричні фігури з великою кількістю вершин). Докладнішу інформацію див. <link xlink:href="http://www.postgresql.org/docs/current/static/storage-toast.html">документації PostgreSQL щодо 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.
uk: Проблема виникає, якщо у вас є таблиця з досить великими геометріями, але не надто великою кількістю рядків (наприклад, таблиця, що містить межі всіх європейських країн у високій роздільній здатності). Тоді сама таблиця є невеликою, але використовує багато простору 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.
uk: Тепер виконайте запит, в якому використовується оператор геометрії &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>
uk: Щоб перевірити, чи є у вас ця проблема, скористайтеся командою postgresql "EXPLAIN ANALYZE". Більш детальну інформацію та технічні подробиці можна знайти у темі на форумі 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>

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>
uk: та новіша тема на 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
uk: Обхідні шляхи

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:
uk: Розробники 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.
uk: Перший спосіб вирішення проблеми полягає в тому, щоб змусити планувальник запитів використовувати індекс. Перед відправкою запиту надішліть на сервер команду "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:
uk: Другий спосіб вирішення проблеми полягає в тому, щоб зробити послідовне сканування таким же швидким, як вважає планувальник запитів. Це можна досягти, створивши додатковий стовпець, який "кешує" bbox, і зіставляючи його з цим стовпцем. У нашому прикладі команди виглядають так:

note: Tag: para
en: Now change your query to use the &amp;&amp; operator against bbox instead of geom_column, like:
uk: Тепер змініть запит, щоб використовувати оператор &amp;&amp; для bbox замість geom_column, наприклад:

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.
uk: Звичайно, якщо ви змінюєте або додаєте рядки до таблиці mytable, ви повинні синхронізувати bbox. Найпростіший спосіб зробити це — використовувати тригери, але ви також можете змінити свою програму, щоб стовпець bbox завжди був актуальним, або виконувати запит UPDATE після кожної зміни.

note: Tag: title
en: CLUSTERing on geometry indices
uk: Кластеризація за геометричними індексами

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.)
uk: Для таблиць, які в основному є тільки для читання і де для більшості запитів використовується один індекс, PostgreSQL пропонує команду CLUSTER. Ця команда фізично перевпорядковує всі рядки даних у тому ж порядку, що й критерії індексу, що дає дві переваги в продуктивності: По-перше, для сканування діапазону індексу кількість пошуків у таблиці даних значно зменшується. По-друге, якщо робочий набір зосереджений на невеликих інтервалах індексів, ви отримуєте більш ефективне кешування, оскільки рядки даних розподіляються між меншою кількістю сторінок даних. (Запрошуємо вас ознайомитися з документацією команди CLUSTER у посібнику PostgreSQL.)

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:
uk: Однак на даний момент PostgreSQL не дозволяє кластеризацію на індексах PostGIS GIST, оскільки індекси GIST просто ігнорують значення NULL, і ви отримуєте таке повідомлення про помилку:

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:
uk: Як вказує повідомлення HINT, цю недоліку можна обійти, додавши до таблиці обмеження "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.
uk: Звичайно, це не спрацює, якщо вам насправді потрібні значення NULL у стовпці геометрії. Крім того, ви повинні використовувати вищезазначений метод для додавання обмеження, використання обмеження CHECK, такого як "ALTER TABLE blubb ADD CHECK (geometry is not null);" не спрацює.

note: Tag: title
en: Avoiding dimension conversion
uk: Уникнення перетворення вимірів

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:
uk: Іноді в таблиці трапляються дані 3D або 4D, але доступ до них завжди здійснюється за допомогою функцій ST_AsText() або ST_AsBinary(), сумісних з OpenGIS, які виводять тільки 2D-геометрії. Вони роблять це шляхом внутрішнього виклику функції ST_Force2D(), що створює значне навантаження для великих геометрій. Щоб уникнути цього навантаження, можна попередньо видалити ці додаткові виміри один раз і назавжди:

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.
uk: Зверніть увагу, що якщо ви додали стовпець геометрії за допомогою 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.
uk: У разі великих таблиць може бути доцільним розділити це оновлення на менші частини, обмеживши оновлення частиною таблиці за допомогою оператора WHERE та вашого первинного ключа або іншого можливого критерію, а також виконавши просту команду "VACUUM;" між оновленнями. Це значно зменшує потребу в тимчасовому дисковому просторі. Крім того, якщо ви маєте змішані геометрії розмірів, обмеження UPDATE за допомогою "WHERE dimension(geom)&gt;2" пропускає перезапис геометрій, які вже є у 2D.

note: Tag: title
en: PostGIS &last_release_version; Manual
uk: PostGIS &last_release_version; Посібник користувача

note: Tag: orgname
en: The PostGIS Development Group
uk: Група розробників 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>
uk: <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.
uk: PostGIS — це розширення для об'єктно-реляційної системи баз даних <link xlink:href="https://www.postgresql.org/">PostgreSQL</link>, яке дозволяє зберігати об'єкти ГІС (географічних інформаційних систем) у базі даних. PostGIS підтримує просторові індекси R-Tree на основі GiST, а також функції для аналізу та обробки об'єктів ГІС.

note: Tag: para
en: This is the manual for version &last_release_version;
uk: Це інструкція для версії &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>.
uk: Ця робота ліцензована за ліцензією <link xlink:href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution-Share Alike 3.0 License</link>. Ви можете використовувати цей матеріал будь-яким чином, але просимо вас вказати посилання на проект PostGIS та, по можливості, на <link xlink:href="https://postgis.net">https://postgis.net</link>.

note: Tag: title
en: PostGIS Special Functions Index
uk: Спеціальні функції PostGIS Вказівник

note: Tag: title
en: PostGIS Aggregate Functions
uk: Агрегатні функції 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>.
uk: Нижче наведено просторові агрегатні функції, які використовуються так само, як і агрегатні функції SQL, такі як <code>sum</code> та <code>average</code>.

note: Tag: title
en: PostGIS Window Functions
uk: Віконні функції 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.
uk: Наведені нижче функції є віконними просторовими функціями, які використовуються так само, як і віконні функції SQL, такі як <code>row_number()</code>, <code>lead()</code> та <code>lag()</code>. За ними має слідувати оператор <code>OVER()</code>.

note: Tag: title
en: PostGIS SQL-MM Compliant Functions
uk: Функції, сумісні з PostGIS SQL-MM

note: Tag: para
en: The functions given below are PostGIS functions that conform to the SQL/MM 3 standard
uk: Наведені нижче функції є функціями PostGIS, які відповідають стандарту SQL/MM 3

note: Tag: title
en: PostGIS Geography Support Functions
uk: Функції підтримки географії 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.
uk: Наведені нижче функції та оператори є функціями/операторами PostGIS, які приймають як вхідні дані або повертають як вихідні дані об'єкт типу даних <link linkend="PostGIS_Geography">geography</link>.

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)
uk: Функції з (T) не є вбудованими геодезичними функціями і використовують виклик ST_Transform до та з геометрії для виконання операції. Як результат, вони можуть поводитися не так, як очікується, при перетині лінії зміни дати, полюсів, а також для великих геометрій або пар геометрій, що охоплюють більше однієї зони UTM. Базове перетворення - (віддаючи перевагу UTM, азимутальному проектуванню Ламберта (північ/південь) і, в гіршому випадку, проектуванню Меркатора)

note: Tag: title
en: PostGIS Raster Support Functions
uk: Функції підтримки растрових даних 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.
uk: Наведені нижче функції та оператори є функціями/операторами PostGIS, які приймають як вхідні дані або повертають як вихідні дані об'єкт типу даних <xref linkend="raster"/>. Перелічені в алфавітному порядку.

note: Tag: title
en: PostGIS Geometry / Geography / Raster Dump Functions
uk: Функції 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.
uk: Наведені нижче функції є функціями PostGIS, які приймають як вхідні дані або повертають як вихідні дані набір або окремий об'єкт типу даних <link linkend="geometry_dump">geometry_dump</link> або <link linkend="geomval">geomval</link>.

note: Tag: title
en: PostGIS Box Functions
uk: Функції PostGIS Box

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>
uk: Наведені нижче функції є функціями PostGIS, які приймають як вхідні дані або повертають як вихідні дані сімейство просторових типів PostGIS box*. Сімейство типів box складається з <link linkend="box2d_type">box2d</link> та <link linkend="box3d_type">box3d</link>

note: Tag: title
en: PostGIS Functions that support 3D
uk: Функції PostGIS, що підтримують 3D

note: Tag: para
en: The functions given below are PostGIS functions that do not throw away the Z-Index.
uk: Наведені нижче функції є функціями PostGIS, які не відкидають Z-індекс.

note: Tag: title
en: PostGIS Curved Geometry Support Functions
uk: Функції підтримки вигнутої геометрії PostGIS

note: Tag: para
en: The functions given below are PostGIS functions that can use CIRCULARSTRING, CURVEPOLYGON, and other curved geometry types
uk: Наведені нижче функції є функціями PostGIS, які можуть використовувати CIRCULARSTRING, CURVEPOLYGON та інші типи кривої геометрії

note: Tag: title
en: PostGIS Polyhedral Surface Support Functions
uk: Функції підтримки багатогранних поверхонь PostGIS

note: Tag: para
en: The functions given below are PostGIS functions that can use POLYHEDRALSURFACE, POLYHEDRALSURFACEM geometries
uk: Наведені нижче функції є функціями PostGIS, які можуть використовувати геометрії POLYHEDRALSURFACE, POLYHEDRALSURFACEM

note: Tag: title
en: PostGIS Function Support Matrix
uk: Матриця підтримки функцій 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.
uk: Нижче наведено алфавітний перелік просторових функцій у 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.
uk: A <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.
uk: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_transform.png"/></imageobject></inlinemediaobject> означає, що це працює, але з вбудованим перетворенням за допомогою cast to geometry, перетворенням у просторове посилання "best 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.
uk: A <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.
uk: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_sfcgal_required.png"/></imageobject></inlinemediaobject> означає, що функція доступна тільки якщо PostGIS скомпільовано з підтримкою SFCGAL.

note: Tag: simpara
en: geom - Basic 2D geometry support (x,y).
uk: geom - Базова підтримка 2D-геометрії (x, y).

note: Tag: simpara
en: geog - Basic 2D geography support (x,y).
uk: geog - Базова підтримка 2D географії (x, y).

note: Tag: simpara
en: 2.5D - basic 2D geometries in 3 D/4D space (has Z or M coord).
uk: 2.5D — базові 2D-геометрії в 3D/4D-просторі (має координати Z або M).

note: Tag: simpara
en: PS - Polyhedral surfaces
uk: PS - Поліедральні поверхні

note: Tag: simpara
en: T - Triangles and Triangulated Irregular Network surfaces (TIN)
uk: T - Трикутники та трикутні нерегулярні мережеві поверхні (TIN)

note: Tag: entry
en: Function
uk: Функція

note: Tag: entry
en: Curves
uk: Криві

note: Tag: title
en: New, Enhanced or changed PostGIS Functions
uk: Нові, вдосконалені або змінені функції PostGIS

note: Tag: title
en: PostGIS Reference
uk: Довідка 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.
uk: Нижче наведено функції, які можуть знадобитися користувачеві 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.
uk: PostGIS розпочав перехід від існуючої конвенції іменування до конвенції, орієнтованої на SQL-MM. В результаті, більшість функцій, які ви знаєте і любите, були перейменовані з використанням стандартного префікса просторового типу (ST). Попередні функції все ще доступні, хоча вони не вказані в цьому документі, де наведено оновлені функції, які є еквівалентними. Функції, що не вказані в цій документації, є застарілими і будуть видалені в майбутніх версіях, тому ПРИПИНІТЬ ЇХ ВИКОРИСТОВУВАТИ.

note: Tag: title
en: Geometry Accessors
uk: Доступ до геометрії

note: Tag: refpurpose
en: Returns the type of a geometry as text.
uk: Повертає тип геометрії у вигляді тексту.

note: Tag: para
en: Returns the type of the geometry as a string. Eg: 'LINESTRING', 'POLYGON', 'MULTIPOINT', etc.
uk: Повертає тип геометрії у вигляді рядка. Наприклад: “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.
uk: OGC SPEC s2.1.1.1 - Повертає ім'я підтипу Geometry, який можна інстанціювати, до якого належить цей екземпляр Geometry. Ім'я підтипу Geometry, який можна інстанціювати, повертається у вигляді рядка.

note: Tag: para
en: This function also indicates if the geometry is measured, by returning a string of the form 'POINTM'.
uk: Ця функція також вказує, чи вимірюється геометрія, повертаючи рядок у вигляді “POINTM”.

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
uk: Покращено: 2.0.0 додано підтримку багатогранних поверхонь, трикутників і TIN.

note: Tag: refpurpose
en: Returns the boundary of a geometry.
uk: Повертає межі геометрії.

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.
uk: Повертає закриття комбінаторної межі цієї геометрії. Комбінаторна межа визначається, як описано в розділі 3.12.3.2 специфікації OGC. Оскільки результат цієї функції є закриттям, а отже, топологічно замкнутим, отриману межу можна представити за допомогою примітивних елементів геометрії, як описано в розділі 3.12.2 специфікації OGC.

note: Tag: para
en: Performed by the GEOS module
uk: Виконано модулем 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).
uk: До версії 2.0.0 ця функція викликає виняток, якщо використовується з <varname>GEOMETRYCOLLECTION</varname>. Починаючи з версії 2.0.0, вона повертає NULL (непідтримуваний вхідний параметр).

note: Tag: para
en: Enhanced: 2.1.0 support for Triangle was introduced
uk: Покращено: 2.1.0 додано підтримку Triangle

note: Tag: para
en: Changed: 3.2.0 support for TIN, does not use geos, does not linearize curves
uk: Змінено: 3.2.0 підтримка TIN, не використовує geos, не лінеаризує криві

note: Tag: para
en: Linestring with boundary points overlaid
uk: Лінія з накладеними граничними точками

note: Tag: para
en: polygon holes with boundary multilinestring
uk: отвори полігону з межею, що складається з декількох ліній

note: Tag: refpurpose
en: Returns the diagonal of a geometry's bounding box.
uk: Повертає діагональ обмежувального прямокутника геометрії.

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.
uk: Повертає діагональ обмежувальної рамки наданої геометрії у вигляді LineString. Діагональ — це 2-точковий LineString із мінімальними значеннями кожного виміру в початковій точці та максимальними значеннями в кінцевій точці. Якщо вхідна геометрія порожня, діагональна лінія є 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.
uk: Додатковий параметр <varname>fits</varname> визначає, чи потрібно знайти найкраще співпадіння. Якщо значення false, можна прийняти діагональ дещо більшої обмежувальної рамки (що швидше обчислюється для геометрій з великою кількістю вершин). У будь-якому випадку обмежувальна рамка поверненої діагональної лінії завжди охоплює вхідну геометрію.

note: Tag: para
en: The returned geometry retains the SRID and dimensionality (Z and M presence) of the input geometry.
uk: Повернена геометрія зберігає 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.
uk: У виняткових випадках (тобто, якщо у вхідних даних є лише одна вершина) повернутий ланцюжок ліній буде формально недійсним (не має внутрішньої частини). Результат все одно залишається топологічно правильним.

note: Tag: refpurpose
en: Return the coordinate dimension of a geometry.
uk: Повертає розмірність координат геометрії.

note: Tag: para
en: Return the coordinate dimension of the ST_Geometry value.
uk: Повертає розмірність координат значення ST_Geometry.

note: Tag: para
en: This is the MM compliant alias name for <xref linkend="ST_NDims"/>
uk: Це ім'я псевдоніма, що відповідає MM, для <xref linkend="ST_NDims"/>

note: Tag: refpurpose
en: Returns the topological dimension of a geometry.
uk: Повертає топологічну розмірність геометрії.

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.
uk: Повертає топологічну розмірність цього об'єкта Geometry, яка повинна бути меншою або дорівнювати розмірності координат. OGC SPEC s2.1.1.1 - повертає 0 для <varname>POINT</varname>, 1 для <varname>LINESTRING</varname>, 2 для <varname>POLYGON</varname> і найбільший вимір компонентів <varname>GEOMETRYCOLLECTION</varname>. Якщо розмір невідомий (наприклад, для порожнього <varname>GEOMETRYCOLLECTION</varname>), повертається 0.

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.
uk: Покращено: 2.0.0 додано підтримку багатогранних поверхонь і TIN. Більше не виникає виняток, якщо задано порожню геометрію.

note: Tag: para
en: Prior to 2.0.0, this function throws an exception if used with empty geometry.
uk: До версії 2.0.0 ця функція викликає виняток, якщо використовується з порожньою геометрією.

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the components of a geometry.
uk: Повертає набір рядків <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).
uk: Функція повернення набору (SRF), яка витягує компоненти геометрії. Вона повертає набір <xref linkend="geometry_dump"/>рядків, кожен з яких містить геометрію (поле <parameter>geom</parameter>) та масив цілих чисел (поле <parameter>path</parameter>).

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.
uk: Для типу атомарної геометрії (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.
uk: ST_Dump корисний для розширення геометрій. Він є оберненим до <xref linkend="ST_Collect"/>/ GROUP BY, оскільки створює нові рядки. Наприклад, його можна використовувати для розширення MULTIPOLYGONS в POLYGONS.

note: Tag: para
en: Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher.
uk: Доступність: 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+
uk: До версії 1.3.4 ця функція виходила з ладу при використанні з геометріями, що містять КРИВІ. Ця проблема вирішена у версії 1.3.4+

note: Tag: title
en: Standard Examples
uk: Стандартні приклади

note: Tag: title
en: Polyhedral Surfaces, TIN and Triangle Examples
uk: Багатогранні поверхні, TIN і приклади трикутників

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the coordinates in a geometry.
uk: Повертає набір рядків <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).
uk: Функція повернення набору (SRF), яка витягує координати (вершини) геометрії. Вона повертає набір <xref linkend="geometry_dump"/>рядків, кожен з яких містить геометрію (поле <parameter>geom</parameter>) та масив цілих чисел (поле <parameter>path</parameter>).

note: Tag: para
en: the <parameter>geom</parameter> field <varname>POINT</varname>s represent the coordinates of the supplied geometry.
uk: поле <parameter>geom</parameter> <varname>POINT</varname>s представляє координати наданої геометрії.

note: Tag: para
en: To obtain a single geometry containing the coordinates use <xref linkend="ST_Points"/>.
uk: Щоб отримати єдину геометрію, що містить координати, використовуйте <xref linkend="ST_Points"/>.

note: Tag: para
en: Enhanced: 2.1.0 Faster speed. Reimplemented as native-C.
uk: Покращено: 2.1.0 Вища швидкість. Перероблено як native-C.

note: Tag: title
en: Classic Explode a Table of LineStrings into nodes
uk: Класичний розрив таблиці рядків у вузли

note: Tag: title
en: Standard Geometry Examples
uk: Приклади стандартної геометрії

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the segments in a geometry.
uk: Повертає набір рядків <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).
uk: Функція повернення набору (SRF), яка витягує сегменти геометрії. Вона повертає набір <xref linkend="geometry_dump"/>рядків, кожен з яких містить геометрію (поле <parameter>geom</parameter>) та масив цілих чисел (поле <parameter>path</parameter>).

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.
uk: поле <parameter>geom</parameter> <varname>LINESTRING</varname>s представляє лінійні сегменти наданої геометрії, а <varname>CIRCULARSTRING</varname>s представляє сегменти дуги.

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.
uk: поле <parameter>path</parameter> (тип <varname>integer[]</varname>) є індексом, що перелічує позиції початкових точок сегментів в елементах наданої геометрії. Індекси починаються з 1. Наприклад, для <varname>LINESTRING</varname> шляхи є <varname>{i}</varname>, де <varname>i</varname> є <varname>n-тою</varname> початковою точкою сегмента в <varname>LINESTRING</varname>. Для <varname>POLYGON</varname> шляхи мають вигляд <varname>{i,j}</varname>, де <varname>i</varname> — номер кільця (1 — зовнішнє, внутрішні кільця йдуть за ним), а <varname>j</varname> — позиція початку сегмента в кільці.

note: Tag: title
en: TIN and Triangle Examples
uk: Приклади TIN і трикутників

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the exterior and interior rings of a Polygon.
uk: Повертає набір рядків <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).
uk: Функція повернення набору (SRF), яка витягує кільця полігону. Вона повертає набір <xref linkend="geometry_dump"/>рядків, кожен з яких містить геометрію (поле <parameter>geom</parameter>) та масив цілих чисел (поле <parameter>path</parameter>).

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.
uk: Поле <parameter>geom</parameter> містить кожне кільце як POLYGON. Поле <parameter>path</parameter> є цілочисельним масивом довжиною 1, що містить індекс кільця полігону. Зовнішнє кільце (оболонка) має індекс 0. Внутрішні кільця (отвори) мають індекси 1 і вище.

note: Tag: para
en: This only works for POLYGON geometries. It does not work for MULTIPOLYGONS
uk: Це працює тільки для геометрії POLYGON. Не працює для MULTIPOLYGONS

note: Tag: para
en: Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher.
uk: Доступність: PostGIS 1.1.3. Вимагає PostgreSQL 7.3 або вище.

note: Tag: para
en: General form of query.
uk: Загальна форма запиту.

note: Tag: para
en: A polygon with a single hole.
uk: Полігон з одним отвором.

note: Tag: refpurpose
en: Returns the last point of a LineString or CircularLineString.
uk: Повертає останню точку 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>.
uk: Повертає останню точку геометрії <varname>LINESTRING</varname> або <varname>CIRCULARLINESTRING</varname> як <varname>POINT</varname>. Повертає <varname>NULL</varname>, якщо вхідні дані не є <varname>LINESTRING</varname> або <varname>CIRCULARLINESTRING</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.
uk: Змінено: 2.0.0 більше не працює з одномірними MultiLineStrings. У старих версіях PostGIS одномірний MultiLineString працював з цією функцією і повертав кінцеву точку. У 2.0.0 він повертає NULL, як і будь-який інший MultiLineString. Стара поведінка була недокументованою функцією, але користувачі, які вважали, що їхні дані зберігаються як LINESTRING, можуть зіткнутися з поверненням NULL у 2.0.0.

note: Tag: para
en: End point of a non-LineString is NULL
uk: Кінцева точка нелінійного об'єкта LineString має значення NULL

note: Tag: para
en: End point of a 3D LineString
uk: Кінцева точка 3D-лінії

note: Tag: para
en: End point of a CircularString
uk: Кінцева точка CircularString

note: Tag: refpurpose
en: Returns a geometry representing the bounding box of a geometry.
uk: Повертає геометрію, що представляє обмежувальну рамку геометрії.

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).
uk: Повертає мінімальну обмежувальну коробку подвійної точності (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>.
uk: У виняткових випадках (вертикальні лінії, точки) буде повернено геометрію з розмірністю, меншою за <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
uk: Доступність: 1.5.0 поведінка змінена на виведення подвійної точності замість float4

note: Tag: para
en: Envelope of a point and linestring.
uk: Огинаюча точки та лінійного відрізка.

note: Tag: refpurpose
en: Returns a LineString representing the exterior ring of a Polygon.
uk: Повертає LineString, що представляє зовнішнє кільце полігону

note: Tag: para
en: Returns a LINESTRING representing the exterior ring (shell) of a POLYGON. Returns NULL if the geometry is not a polygon.
uk: Повертає LineString, що представляє зовнішнє кільце полігону.

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"/>
uk: Ця функція не підтримує MULTIPOLYGON. Для MULTIPOLYGON використовуйте разом з <xref linkend="ST_GeometryN"/>або <xref linkend="ST_Dump"/>

note: Tag: refpurpose
en: Return an element of a geometry collection.
uk: Повернути елемент колекції геометрії.

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.
uk: Повертає N-й елемент геометрії, починаючи з 1, вхідної геометрії, яка є GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTICURVE, MULTI)POLYGON або POLYHEDRALSURFACE. В іншому випадку повертає 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.
uk: Індекс базується на 1, як і в специфікаціях OGC, починаючи з версії 0.8.0. У попередніх версіях це реалізовано на основі 0.

note: Tag: para
en: To extract all elements of a geometry, <xref linkend="ST_Dump"/> is more efficient and works for atomic geometries.
uk: Щоб витягти всі елементи геометрії, <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.
uk: Змінено: 2.0.0 Попередні версії повертали NULL для геометрій в однині. Це було змінено, щоб повертати геометрію для випадку ST_GeometryN(..,1).

note: Tag: refpurpose
en: Returns the SQL-MM type of a geometry as text.
uk: Повертає тип 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.
uk: Повертає тип геометрії у вигляді рядка. Наприклад: “ST_LineString”, “ST_Polygon”,'ST_MultiPolygon' тощо. Ця функція відрізняється від GeometryType(geometry) тим, що повертає строку і ST на початку, а також тим, що не вказує, чи виміряно геометрію.

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
uk: Покращено: 2.0.0 додано підтримку багатогранних поверхонь.

note: Tag: refpurpose
en: Tests if a geometry contains a circular arc
uk: Тестує, чи містить геометрія кругову дугу

note: Tag: para
en: Returns true if a geometry or geometry collection contains a circular string
uk: Повертає true, якщо геометрія або колекція геометрій містить циклічну строку

note: Tag: para
en: Availability: 1.2.3?
uk: Доступність: 1.2.3?

note: Tag: refpurpose
en: Returns the Nth interior ring (hole) of a Polygon.
uk: Повертає 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.
uk: Повертає N-те внутрішнє кільце (отвір) геометрії POLYGON як LINESTRING. Індекс починається з 1. Повертає NULL, якщо геометрія не є полігоном або індекс виходить за межі діапазону.

note: Tag: refpurpose
en: Return the number of component curves in a CompoundCurve.
uk: Повернути кількість кривих компонентів у CompoundCurve.

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.
uk: Повертає кількість компонентних кривих у CompoundCurve, нуль для порожнього CompoundCurve або NULL для вхідних даних, що не є CompoundCurve.

note: Tag: refpurpose
en: Returns the Nth component curve geometry of a CompoundCurve.
uk: Повертає геометрію N-го компонента кривої CompoundCurve.

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.
uk: Повертає геометрію N-го компонента кривої CompoundCurve. Індекс починається з 1. Повертає NULL, якщо геометрія не є CompoundCurve або індекс знаходиться поза діапазоном.

note: Tag: refpurpose
en: Tests if a LineStrings's start and end points are coincident. For a PolyhedralSurface tests if it is closed (volumetric).
uk: Перевіряє, чи збігаються початкова та кінцева точки LineStrings. Для PolyhedralSurface перевіряє, чи є вона закритою (об'ємною).

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).
uk: Повертає <varname>TRUE</varname>, якщо початкова та кінцева точки <varname>LINESTRING</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>.
uk: SQL-MM визначає результат <code>ST_IsClosed(NULL)</code> як 0, тоді як PostGIS повертає <varname>NULL</varname>.

note: Tag: title
en: Line String and Point Examples
uk: Приклади LineString і Point

note: Tag: title
en: Polyhedral Surface Examples
uk: Приклади багатогранних поверхонь

note: Tag: refpurpose
en: Tests if a geometry is a geometry collection type.
uk: Перевіряє, чи є геометрія типом колекції геометрії.

note: Tag: para
en: Returns <varname>TRUE</varname> if the geometry type of the argument a geometry collection type. Collection types are the following:
uk: Повертає <varname>TRUE</varname>, якщо тип геометрії аргументу є типом колекції геометрії. Типи колекцій є такими:

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.
uk: Ця функція аналізує тип геометрії. Це означає, що вона поверне <varname>TRUE</varname> для колекцій, які порожні або містять один елемент.

note: Tag: refpurpose
en: Tests if a geometry is empty.
uk: Перевіряє, чи геометрія порожня.

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.
uk: Повертає true, якщо ця геометрія є порожньою. Якщо true, то ця геометрія представляє порожню колекцію геометрії, полігон, точку тощо.

note: Tag: para
en: SQL-MM defines the result of ST_IsEmpty(NULL) to be 0, while PostGIS returns NULL.
uk: 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
uk: Змінено: 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.
uk: Перевіряє, чи мають полігони зовнішні кільця, орієнтовані проти годинникової стрілки, і внутрішні кільця, орієнтовані за годинниковою стрілкою.

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.
uk: Повертає true, якщо всі полігональні компоненти вхідної геометрії використовують орієнтацію проти годинникової стрілки для зовнішнього кільця і за годинниковою стрілкою для всіх внутрішніх кілець.

note: Tag: para
en: Returns true if the geometry has no polygonal components.
uk: Повертає 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.
uk: Закриті лінії не вважаються полігональними компонентами, тому ви все одно отримаєте правильний результат, передавши одну закриту лінію незалежно від її орієнтації.

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.
uk: Якщо полігональна геометрія не використовує зворотну орієнтацію для внутрішніх кілець (тобто, якщо одне або більше внутрішніх кілець орієнтовані в тому ж напрямку, що і зовнішнє кільце), то обидва ST_IsPolygonCW і ST_IsPolygonCCW повернуть false.

note: Tag: para
en: Availability: 2.4.0
uk: Доступність: 2.4.0

note: Tag: refpurpose
en: Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise.
uk: Перевіряє, чи полігони мають зовнішні кільця, орієнтовані за годинниковою стрілкою, а внутрішні кільця — проти годинникової стрілки.

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.
uk: Повертає true, якщо всі полігональні компоненти вхідної геометрії використовують орієнтацію за годинниковою стрілкою для зовнішнього кільця і проти годинникової стрілки для всіх внутрішніх кілець.

note: Tag: refpurpose
en: Tests if a LineString is closed and simple.
uk: Перевіряє, чи лінія LineString є замкнутою та простою.

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).
uk: Повертає <varname>TRUE</varname>, якщо цей <varname>LINESTRING</varname> є одночасно <xref linkend="ST_IsClosed"/>(<code>ST_StartPoint(g) ~= ST_Endpoint(g)</code>) і <xref linkend="ST_IsSimple"/>(не перетинається сам із собою).

note: Tag: para
en: SQL-MM defines the result of <code>ST_IsRing(NULL)</code> to be 0, while PostGIS returns <varname>NULL</varname>.
uk: 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.
uk: Перевіряє, чи геометрія не має точок самоперетину або самодотику.

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>
uk: Повертає значення 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.
uk: SQL-MM визначає результат ST_IsSimple(NULL) як 0, тоді як PostGIS повертає NULL.

note: Tag: refpurpose
en: Returns the M coordinate of a Point.
uk: Повертає координату M точки.

note: Tag: para
en: Return the M coordinate of a Point, or NULL if not available. Input must be a Point.
uk: Повертає координату 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.
uk: Це (поки що) не є частиною специфікації OGC, але наведено тут для повноти переліку функцій вилучення координат точок.

note: Tag: refpurpose
en: Returns the amount of memory space a geometry takes.
uk: Повертає обсяг пам'яті, який займає геометрія.

note: Tag: para
en: Returns the amount of memory space (in bytes) the geometry takes.
uk: Повертає обсяг пам'яті (у байтах), який займає геометрія.

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.
uk: Це доповнює вбудовані в PostgreSQL <link xlink:href="https://www.postgresql.org/docs/current/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.
uk: pg_relation_size, що повертає розмір таблиці в байтах, може повернути розмір, менший за ST_MemSize. Це відбувається тому, що pg_relation_size не додає розмір тостованих таблиць, а великі геометрії зберігаються в таблицях TOAST.

note: Tag: para
en: pg_total_relation_size - includes, the table, the toasted tables, and the indexes.
uk: pg_total_relation_size - включає таблицю, тостовані таблиці та індекси.

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
uk: pg_column_size повертає, скільки місця займає геометрія в стовпці з урахуванням стиснення, тому може бути менше, ніж ST_MemSize.

note: Tag: para
en: Changed: 2.2.0 name changed to ST_MemSize to follow naming convention.
uk: Змінено: 2.2.0 назва змінено на ST_MemSize відповідно до правил іменування.

note: Tag: refpurpose
en: Returns the coordinate dimension of a geometry.
uk: Повертає розмір координат геометрії.

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
uk: Повертає розмірність координат геометрії. PostGIS підтримує 2 - (x,y) , 3 - (x,y,z) або 2D з мірою - x,y,m, і 4 - 3D з мірою простору x,y,z,m

note: Tag: refpurpose
en: Returns the number of points (vertices) in a geometry.
uk: Повертає кількість точок (вершин) у геометрії.

note: Tag: para
en: Return the number of points in a geometry. Works for all geometries.
uk: Повертає кількість точок у геометрії. Працює для всіх геометрій.

note: Tag: refpurpose
en: Returns the number of rings in a polygonal geometry.
uk: Повертає кількість кілець у полігональній геометрії.

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.
uk: Якщо геометрія є полігоном або мультиполігоном, повертає кількість кілець. На відміну від NumInteriorRings, враховує також зовнішні кільця.

note: Tag: refpurpose
en: Returns the number of elements in a geometry collection.
uk: Повертає кількість елементів у колекції геометрії.

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.
uk: Повертає кількість елементів у колекції геометрій (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.
uk: Змінено: 2.0.0 У попередніх версіях це повертало NULL, якщо геометрія не була типом колекції/MULTI. 2.0.0+ тепер повертає 1 для одиночних геометрій, наприклад POLYGON, LINESTRING, POINT.

note: Tag: refpurpose
en: Returns the number of interior rings (holes) of a Polygon.
uk: Повертає кількість внутрішніх кілець (отворів) полігону.

note: Tag: para
en: Return the number of interior rings of a polygon geometry. Return NULL if the geometry is not a polygon.
uk: Повертає кількість внутрішніх кілець геометрії полігону. Повертає 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.
uk: Змінено: 2.0.0 - у попередніх версіях дозволялося передавати MULTIPOLYGON, повертаючи кількість внутрішніх кілець першого POLYGON.

note: Tag: refpurpose
en: Returns the number of interior rings (holes) of a Polygon. Aias for ST_NumInteriorRings
uk: Повертає кількість внутрішніх кілець (отворів) полігону. Aias для ST_NumInteriorRings

note: Tag: refpurpose
en: Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries.
uk: Повертає кількість граней на багатогранній поверхні. Для небагатогранних геометрій повертає нуль.

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.
uk: Повертає кількість граней на багатогранній поверхні. Для геометрій, що не є багатогранними, повертає нуль. Це псевдонім для ST_NumGeometries для підтримки іменування MM. Якщо вам не важлива конвенція MM, швидше використовувати ST_NumGeometries.

note: Tag: refpurpose
en: Returns the number of points in a LineString or CircularString.
uk: Повертає кількість точок у LineString або CircularString.

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.
uk: Повертає кількість точок у значенні ST_LineString або ST_CircularString. До версії 1.4 працює тільки з лініями, як зазначено в специфікації. Починаючи з версії 1.4, це псевдонім для ST_NPoints, який повертає кількість вершин не тільки для лінійних рядків. Розгляньте можливість використання ST_NPoints, який є багатоцільовим і працює з багатьма типами геометрії.

note: Tag: refpurpose
en: Returns the Nth geometry (face) of a PolyhedralSurface.
uk: Повертає 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.
uk: Повертає N-ту геометрію (грань), починаючи з 1, якщо геометрія є POLYHEDRALSURFACE або POLYHEDRALSURFACEM. В іншому випадку повертає NULL. Повертає той самий результат, що й ST_GeometryN для PolyhedralSurfaces. Використання ST_GeometryN є швидшим.

note: Tag: para
en: Index is 1-based.
uk: Індекс починається з 1.

note: Tag: para
en: If you want to extract all elements of a geometry <xref linkend="ST_Dump"/> is more efficient.
uk: Якщо ви хочете витягти всі елементи геометрії, <xref linkend="ST_Dump"/>є більш ефективним.

note: Tag: refpurpose
en: Returns the Nth point in the first LineString or circular LineString in a geometry.
uk: Повертає N-ту точку в першому LineString або круговому LineString в геометрії.

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.
uk: Повертає N-ту точку в одній лінійній або круговій лінійній геометрії. Негативні значення відраховуються назад від кінця LineString, так що -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.
uk: Індекс починається з 1, як і в специфікаціях OGC, починаючи з версії 0.8.0. Зворотне індексування (негативний індекс) не передбачено в OGC. У попередніх версіях це реалізовано як індекс, що починається з 0.

note: Tag: para
en: If you want to get the Nth point of each LineString in a MultiLineString, use in conjunction with ST_Dump
uk: Якщо ви хочете отримати N-ту точку кожного LineString у MultiLineString, використовуйте разом із 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.
uk: Змінено: 2.0.0 більше не працює з одногеометричними мультилініями. У старіших версіях PostGIS — одинарну мультилінію працював би з цією функцією без проблем і повертав би початкову точку. У 2.0.0 він просто повертає NULL, як і будь-який інший мультилінії.

note: Tag: para
en: Changed: 2.3.0 : negative indexing available (-1 is last point)
uk: Змінено: 2.3.0: доступне негативне індексування (-1 — останній пункт)

note: Tag: refpurpose
en: Returns a MultiPoint containing the coordinates of a geometry.
uk: Повертає об'єкт MultiPoint, що містить координати геометрії.

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).
uk: Повертає MultiPoint, що містить усі координати геометрії. Дублікати точок зберігаються, включаючи початкову та кінцеву точки кільцевих геометрій. (За бажанням дублікати точок можна видалити, викликавши <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"/>.
uk: Щоб отримати інформацію про положення кожної координати в батьківській геометрії, використовуйте <xref linkend="ST_DumpPoints"/>.

note: Tag: para
en: M and Z coordinates are preserved if present.
uk: Координати M і Z зберігаються, якщо вони є.

note: Tag: refpurpose
en: Returns the first point of a LineString.
uk: Повертає першу точку LineString.

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>.
uk: Повертає першу точку геометрії <varname>LINESTRING</varname> або <varname>CIRCULARLINESTRING</varname> як <varname>POINT</varname>. Повертає <varname>NULL</varname>, якщо вхідні дані не є <varname>LINESTRING</varname> або <varname>CIRCULARLINESTRING</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.
uk: Покращено: 3.2.0 повертає точку для всіх геометрій. Попередня поведінка повертала NULL, якщо вхідні дані не були LineString.

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.
uk: Змінено: 2.0.0 більше не працює з одномірними геометричними об'єктами MultiLineStrings. У старих версіях PostGIS одномірний MultiLineString працював з цією функцією без проблем і повертав початкову точку. У 2.0.0 він просто повертає NULL, як і будь-який інший MultiLineString. Стара поведінка була недокументованою функцією, але користувачі, які вважали, що їхні дані зберігаються як LINESTRING, можуть зіткнутися з поверненням NULL у 2.0.0.

note: Tag: para
en: Start point of a LineString
uk: Початкова точка лінії

note: Tag: para
en: Start point of a non-LineString is NULL
uk: Початкова точка нелінійного об'єкта LineString має значення NULL

note: Tag: para
en: Start point of a 3D LineString
uk: Початкова точка 3D-лінії

note: Tag: para
en: Start point of a CircularString
uk: Початкова точка CircularString

note: Tag: refpurpose
en: Returns a text summary of the contents of a geometry.
uk: Повертає текстовий підсумок вмісту геометрії.

note: Tag: para
en: Returns a text summary of the contents of the geometry.
uk: Повертає текстовий підсумок вмісту геометрії.

note: Tag: para
en: Flags shown square brackets after the geometry type have the following meaning:
uk: Прапорці, що відображаються в квадратних дужках після типу геометрії, мають таке значення:

note: Tag: para
en: M: has M coordinate
uk: M: має координату M

note: Tag: para
en: Z: has Z coordinate
uk: Z: має координату Z

note: Tag: para
en: B: has a cached bounding box
uk: B: має кешовану обмежувальну рамку

note: Tag: para
en: G: is geodetic (geography)
uk: G: геодезичний (географія)

note: Tag: para
en: S: has spatial reference system
uk: S: має просторову систему координат

note: Tag: para
en: Availability: 1.2.2
uk: Доступність: 1.2.2

note: Tag: para
en: Enhanced: 2.0.0 added support for geography
uk: Покращено: у версії 2.0.0 додано підтримку географії

note: Tag: para
en: Enhanced: 2.1.0 S flag to denote if has a known spatial reference system
uk: Покращено: 2.1.0 Прапор S для позначення наявності відомої системи просторових координат

note: Tag: para
en: Enhanced: 2.2.0 Added support for TIN and Curves
uk: Покращено: 2.2.0 Додано підтримку TIN і кривих

note: Tag: refpurpose
en: Returns the X coordinate of a Point.
uk: Повертає координату X точки.

note: Tag: para
en: Return the X coordinate of the point, or NULL if not available. Input must be a point.
uk: Повертає координату 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"/>.
uk: Щоб отримати мінімальне та максимальне значення X координат геометрії, використовуйте функції <xref linkend="ST_XMin"/> та <xref linkend="ST_XMax"/>.

note: Tag: refpurpose
en: Returns the Y coordinate of a Point.
uk: Повертає координату Y точки.

note: Tag: para
en: Return the Y coordinate of the point, or NULL if not available. Input must be a point.
uk: Повертає координату 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"/>.
uk: Щоб отримати мінімальне та максимальне значення Y координат геометрії, використовуйте функції <xref linkend="ST_YMin"/> та <xref linkend="ST_YMax"/>.

note: Tag: refpurpose
en: Returns the Z coordinate of a Point.
uk: Повертає координату Z точки.

note: Tag: para
en: Return the Z coordinate of the point, or NULL if not available. Input must be a point.
uk: Повертає координату 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"/>.
uk: Щоб отримати мінімальне та максимальне значення 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>
uk: <refpurpose>Повертає код, що вказує на розмірність координат ZM геометрії.</refpurpose>

note: Tag: para
en: <para>Returns a code indicating the ZM coordinate dimension of a geometry.</para>
uk: <para>Повертає код, що вказує на розмірність координат ZM геометрії.</para>

note: Tag: para
en: Values are: 0 = 2D, 1 = 3D-M, 2 = 3D-Z, 3 = 4D.
uk: Значення: 0 = 2D, 1 = 3D-M, 2 = 3D-Z, 3 = 4D.

note: Tag: refpurpose
en: Checks if a geometry has a Z dimension.
uk: Перевіряє, чи має геометрія розмір 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.
uk: Перевіряє, чи має вхідна геометрія розмір 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.
uk: Геометричні об'єкти з розміром Z зазвичай представляють тривимірні (3D) геометрії, тоді як об'єкти без цього розміру є двовимірними (2D) геометріями.

note: Tag: para
en: This function is useful for determining if a geometry has elevation or height information.
uk: Ця функція корисна для визначення, чи має геометрія інформацію про висоту.

note: Tag: refpurpose
en: Checks if a geometry has an M (measure) dimension.
uk: Перевіряє, чи має геометрія розмір 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.
uk: Перевіряє, чи має вхідна геометрія розмір M (вимір), і повертає булеве значення. Якщо геометрія має розмір M, повертає true; інакше повертає false.

note: Tag: para
en: Geometry objects with an M dimension typically represent measurements or additional data associated with spatial features.
uk: Геометричні об'єкти з розмірністю M зазвичай представляють вимірювання або додаткові дані, пов'язані з просторовими характеристиками.

note: Tag: para
en: This function is useful for determining if a geometry includes measure information.
uk: Ця функція корисна для визначення, чи містить геометрія інформацію про виміри.

note: Tag: title
en: Bounding Box Functions
uk: Функції обмежувальної рамки

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.
uk: Ці функції створюють або оперують обмежувальними рамками. Вони також можуть надавати та приймати значення геометрії, використовуючи автоматичні або явні приведення типів.

note: Tag: para
en: See also <xref linkend="PostGIS_BoxFunctions"/>.
uk: Див. також <xref linkend="PostGIS_BoxFunctions"/>.

note: Tag: refpurpose
en: Returns a BOX2D representing the 2D extent of a geometry.
uk: Повертає BOX2D, що представляє 2D розмір геометрії.

note: Tag: para
en: Returns a <xref linkend="box2d_type"/> representing the 2D extent of the geometry.
uk: Повертає <xref linkend="box2d_type"/>, що представляє 2D розмір геометрії.

note: Tag: refpurpose
en: Returns a BOX3D representing the 3D extent of a geometry.
uk: Повертає BOX3D, що представляє 3D-розмір геометрії.

note: Tag: para
en: Returns a <xref linkend="box3d_type"/> representing the 3D extent of the geometry.
uk: Повертає <xref linkend="box3d_type"/>, що представляє 3D-розмір геометрії.

note: Tag: refpurpose
en: Returns the estimated extent of a spatial table.
uk: Повертає приблизний діапазон просторової таблиці.

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"/>.
uk: Повертає приблизний діапазон просторової таблиці у вигляді <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.
uk: За замовчуванням також використовуються статистичні дані, зібрані з дочірніх таблиць (таблиць з 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.
uk: Для PostgreSQL &gt;= 8.0.0 статистика збирається за допомогою VACUUM ANALYZE, а результат буде приблизно 95% від фактичного. Для PostgreSQL &lt;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.
uk: За відсутності статистики (порожня таблиця або не викликано 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."
uk: Для імен таблиць та/або просторів імен, що містять спеціальні символи та лапки, може знадобитися спеціальна обробка. Користувач зазначає: "Для схем і таблиць використовуйте правила екранування ідентифікаторів, щоб створити рядок у подвійних лапках, а потім видаліть перший і останній символи подвійних лапок. Для стовпця геометрії передайте як є"

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent.
uk: Змінено: 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.
uk: Повертає обмежувальну рамку, розширену з іншої обмежувальної рамки або геометрії.

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.
uk: Повертає обмежувальну рамку, розширену від обмежувальної рамки вхідних даних, або шляхом вказання єдиної відстані, на яку слід розширити рамку по обох осях, або шляхом вказання відстані розширення для кожної осі. Використовує подвійну точність. Може використовуватися для запитів відстані або для додавання фільтра обмежувальної рамки до запиту, щоб скористатися перевагами просторового індексу.

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.
uk: На додаток до версії 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.
uk: Відстані вказані в одиницях просторової системи координат вхідних даних.

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.
uk: ST_Expand схожий на <xref linkend="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.
uk: До версії 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.
uk: Доступність: 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.
uk: Покращено: додано підтримку версії 2.3.0 для розширення поля на різну величину в різних вимірах.

note: Tag: para
en: Examples below use US National Atlas Equal Area (SRID=2163) which is a meter projection
uk: У наведених нижче прикладах використовується карта США National Atlas Equal Area (SRID=2163), яка є метровою проекцією

note: Tag: refpurpose
en: Aggregate function that returns the bounding box of geometries.
uk: Агрегатна функція, яка повертає обмежувальну рамку геометрій.

note: Tag: para
en: An aggregate function that returns a <xref linkend="box2d_type"/> bounding box that bounds a set of geometries.
uk: Агрегатна функція, яка повертає обмежувальну рамку <xref linkend="box2d_type"/>, що обмежує набір геометрій.

note: Tag: para
en: The bounding box coordinates are in the spatial reference system of the input geometries.
uk: Координати обмежувальної рамки знаходяться в просторовій системі координат вхідних геометрій.

note: Tag: para
en: ST_Extent is similar in concept to Oracle Spatial/Locator's SDO_AGGR_MBR.
uk: ST_Extent за своєю концепцією схожий на SDO_AGGR_MBR Oracle Spatial/Locator.

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"/>.
uk: ST_Extent повертає прямокутники тільки з координатами X і Y, навіть для 3D-геометрій. Щоб повернути координати XYZ, використовуйте <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.
uk: Повернене значення <code>box3d</code> не містить SRID. Використовуйте <xref linkend="ST_SetSRID"/>, щоб перетворити його на геометрію з метаданими SRID. SRID є таким самим, як і вхідні геометрії.

note: Tag: para
en: Examples below use Massachusetts State Plane ft (SRID=2249)
uk: У наведених нижче прикладах використовується система координат штату Массачусетс (SRID=2249)

note: Tag: refpurpose
en: Aggregate function that returns the 3D bounding box of geometries.
uk: Агрегатна функція, яка повертає 3D обмежувальну рамку геометрій.

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.
uk: Агрегатна функція, яка повертає обмежувальну рамку <xref linkend="box3d_type"/>(включає координату Z), що обмежує набір геометрій.

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Extent3D
uk: Змінено: 2.0.0 У попередніх версіях це називалося ST_Extent3D

note: Tag: refpurpose
en: Creates a BOX2D defined by two 2D point geometries.
uk: Створює BOX2D, визначений двома 2D точковими геометріями.

note: Tag: para
en: Creates a <xref linkend="box2d_type"/> defined by two Point geometries. This is useful for doing range queries.
uk: Створює <xref linkend="box2d_type"/>, визначений двома геометріями Point. Це корисно для виконання запитів діапазону.

note: Tag: refpurpose
en: Creates a BOX3D defined by two 3D point geometries.
uk: Створює BOX3D, визначений двома геометріями 3D-точок.

note: Tag: para
en: Creates a <xref linkend="box3d_type"/> defined by two 3D Point geometries.
uk: Створює <xref linkend="box3d_type"/>, визначений двома геометріями 3D Point.

note: Tag: para
en: This function supports 3D and will not drop the z-index.
uk: Ця функція підтримує 3D і не знижує z-індекс.

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D
uk: Змінено: 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>
uk: <refpurpose>Повертає X максимум 2D або 3D обмежувальної рамки або геометрії.</refpurpose>

note: Tag: para
en: <para>Returns the X maxima of a 2D or 3D bounding box or a geometry.</para>
uk: <para>Повертає X максимум 2D або 3D обмежувальної рамки або геометрії.</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.
uk: Хоча ця функція визначена тільки для box3d, вона також працює для значень box2d і geometry завдяки автоматичному перетворенню. Однак вона не приймає текстове представлення geometry або box2d, оскільки вони не перетворюються автоматично.

note: Tag: refpurpose
en: <refpurpose>Returns the X minima of a 2D or 3D bounding box or a geometry.</refpurpose>
uk: <refpurpose>Повертає мінімальне значення X для 2D або 3D обмежувальної рамки або геометрії.</refpurpose>

note: Tag: para
en: <para>Returns the X minima of a 2D or 3D bounding box or a geometry.</para>
uk: <para>Повертає мінімальне значення X для 2D або 3D обмежувальної рамки або геометрії.</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.
uk: Хоча ця функція визначена тільки для box3d, вона також працює для значень box2d і geometry завдяки автоматичному перетворенню. Однак вона не приймає текстове представлення geometry або box2d, оскільки вони не перетворюються автоматично.

note: Tag: refpurpose
en: <refpurpose>Returns the Y maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
uk: <refpurpose>Повертає максимальне значення Y 2D або 3D обмежувальної рамки або геометрії.</refpurpose>

note: Tag: para
en: <para>Returns the Y maxima of a 2D or 3D bounding box or a geometry.</para>
uk: <para>Повертає максимальне значення Y 2D або 3D обмежувальної рамки або геометрії.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Y minima of a 2D or 3D bounding box or a geometry.</refpurpose>
uk: <refpurpose>Повертає мінімальне значення Y для 2D або 3D обмежувальної рамки або геометрії.</refpurpose>

note: Tag: para
en: <para>Returns the Y minima of a 2D or 3D bounding box or a geometry.</para>
uk: <para>Повертає мінімальне значення Y 2D або 3D обмежувальної рамки або геометрії.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Z maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
uk: <refpurpose>Повертає максимальне значення Z для 2D або 3D обмежувальної рамки або геометрії.</refpurpose>

note: Tag: para
en: <para>Returns the Z maxima of a 2D or 3D bounding box or a geometry.</para>
uk: <para>Повертає максимальне значення Z для 2D або 3D обмежувальної рамки або геометрії..</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Z minima of a 2D or 3D bounding box or a geometry.</refpurpose>
uk: <refpurpose>Повертає мінімальне значення Z для 2D або 3D обмежувальної рамки або геометрії.</refpurpose>

note: Tag: para
en: <para>Returns the Z minima of a 2D or 3D bounding box or a geometry.</para>
uk: <para>Повертає мінімальне значення Z 2D- або 3D-обмежувальної рамки або геометрії.</para>

note: Tag: title
en: Clustering Functions
uk: Функції кластеризації

note: Tag: para
en: These functions implement clustering algorithms for sets of geometries.
uk: Ці функції реалізують алгоритми кластеризації для наборів геометрій.

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
uk: Функція вікна, яка повертає ідентифікатор кластера для кожної вхідної геометрії за допомогою алгоритму 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.
uk: Віконна функція, яка повертає номер кластера для кожної вхідної геометрії, використовуючи 2D <link xlink:href="https://en.wikipedia.org/wiki/DBSCAN">алгоритм просторового кластеризації додатків на основі щільності з шумом (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:
uk: Геометрія входу додається до кластера, якщо вона:

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
uk: "Основна" геометрія, яка знаходиться в межах <varname>eps</varname> <link linkend="ST_Distance">відстань</link> щонайменше <varname>minpoints</varname> вхідних геометрій (включно з самою собою); або

note: Tag: para
en: A "border" geometry, that is within <varname>eps</varname> <link linkend="ST_Distance">distance</link> of a core geometry.
uk: Геометрія "border", що знаходиться в межах <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 assigned 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.
uk: Зверніть увагу, що геометрії меж можуть знаходитися на відстані <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.
uk: Геометріям, які не відповідають критеріям для приєднання до будь-якого кластера, присвоюється номер кластера NULL.

note: Tag: para
en: Clustering polygon within 50 meters of each other, and requiring at least 2 polygons per cluster.
uk: Групування полігонів на відстані 50 метрів один від одного, при цьому в кожній групі має бути не менше 2 полігонів.

note: Tag: para
en: Clusters within 50 meters with at least 2 items per cluster. Singletons have NULL for cid
uk: Кластери в межах 50 метрів з щонайменше 2 елементами в кожному кластері. Одиночні елементи мають NULL для cid

note: Tag: para
en: A example showing combining parcels with the same cluster number into geometry collections.
uk: Приклад об'єднання ділянок з однаковим номером кластера в геометричні колекції.

note: Tag: refpurpose
en: Aggregate function that clusters input geometries into connected sets.
uk: Агрегуюча функція, яка групує вхідні геометрії у зв'язані набори.

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.
uk: Агрегатна функція, яка повертає масив GeometryCollections, розділяючи вхідні геометрії на з'єднані кластери, які не перетинаються. Кожна геометрія в кластері перетинається принаймні з однією іншою геометрією в кластері і не перетинається з жодною геометрією в інших кластерах.

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets.
uk: Віконна функція, яка повертає ідентифікатор кластера для кожної вхідної геометрії, групуючи вхідні геометрії у пов'язані набори.

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.
uk: Віконна функція, яка будує з'єднані кластери геометрій, що перетинаються. Можна пройти всі геометрії в кластері, не виходячи з нього. Повертається номер кластера, до якого належить аргумент геометрії, або null для нульових вхідних даних.

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry using the K-means algorithm.
uk: Віконна функція, яка повертає ідентифікатор кластера для кожної вхідної геометрії за допомогою алгоритму K-means.

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.
uk: Повертає <link xlink:href="https://en.wikipedia.org/wiki/K-means_clustering">K-means</link> номер кластера для кожної вхідної геометрії. Відстань, що використовується для кластеризації, - це відстань між центроїдами для 2D-геометрій і відстань між центрами обмежувальних рамок для 3D-геометрій. Для вхідних даних 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.
uk: <varname>max_radius</varname>, якщо встановлено, змусить ST_ClusterKMeans генерувати більше кластерів, ніж <varname>k</varname>, гарантуючи, що жоден кластер у вихідних даних не матиме радіус, більший за <varname>max_radius</varname>. Це корисно для аналізу доступності.

note: Tag: para
en: Enhanced: 3.2.0 Support for <varname>max_radius</varname>
uk: Покращено: 3.2.0 Підтримка <varname>max_radius</varname>

note: Tag: para
en: Enhanced: 3.1.0 Support for 3D geometries and weights
uk: Покращено: 3.1.0 Підтримка 3D-геометрії та ваги

note: Tag: para
en: Generate dummy set of parcels for examples:
uk: Створити фіктивний набір посилок для прикладів:

note: Tag: para
en: Parcels color-coded by cluster number (cid)
uk: Пакунки, позначені кольором за номером кластера (cid)

note: Tag: para
en: Partitioning parcel clusters by type:
uk: Розподіл кластерів ділянок за типом:

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:
uk: Приклад: Кластеризація попередньо агрегованого набору даних про населення планетарного масштабу за допомогою 3D-кластеризації та зважування. Визначте щонайменше 20 регіонів на основі <link xlink:href="https://data.humdata.org/dataset/kontur-population-dataset">даних про населення Kontur</link>, які не простягаються більше ніж на 3000 км від їхнього центру:

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.
uk: Населення світу, скупчене вище зазначених показників, утворює 46 кластерів. Кластери зосереджені в густонаселених регіонах (Нью-Йорк, Москва). Гренландія є одним кластером. Існують острівні кластери, що простягаються через антимеридіан. Краї кластерів повторюють кривизну Землі.

note: Tag: refpurpose
en: Aggregate function that clusters geometries by separation distance.
uk: Агрегатна функція, яка групує геометрії за відстанню розділення.

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.
uk: Агрегатна функція, яка повертає масив GeometryCollections, де кожна колекція є кластером, що містить деякі вхідні геометрії. Кластеризація розділяє вхідні геометрії на набори, в яких кожна геометрія знаходиться в межах заданої <parameter>відстані</parameter> від принаймні однієї іншої геометрії в тому самому кластері. Відстані є декартовими відстанями в одиницях SRID.

note: Tag: para
en: ST_ClusterWithin is equivalent to running <xref linkend="ST_ClusterDBSCAN"/> with <code>minpoints =&gt; 0</code>.
uk: 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.
uk: Віконна функція, яка повертає ідентифікатор кластера для кожної вхідної геометрії, кластеризуючи за відстанню розділення.

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.
uk: Віконна функція, яка повертає номер кластера для кожної вхідної геометрії. Кластеризація розділяє геометрії на набори, в яких кожна геометрія знаходиться в межах заданої відстані <varname>distance</varname> від принаймні однієї іншої геометрії в тому самому кластері. Відстані є декартовими відстанями в одиницях SRID.

note: Tag: para
en: ST_ClusterWithinWin is equivalent to running <xref linkend="ST_ClusterDBSCAN"/> with <code>minpoints =&gt; 0</code>.
uk: ST_ClusterWithinWin еквівалентно виконанню <xref linkend="ST_ClusterDBSCAN"/> з <code>minpoints =&gt; 0</code>.

note: Tag: title
en: Geometry Constructors
uk: Конструктори геометрії

note: Tag: refpurpose
en: Creates a GeometryCollection or Multi* geometry from a set of geometries.
uk: Створює GeometryCollection або Multi* геометрію з набору геометрій.

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.
uk: Збирає геометрії в колекцію геометрій. Результатом є або Multi*, або GeometryCollection, залежно від того, чи мають вхідні геометрії однаковий або різний тип (однорідні або неоднорідні). Вхідні геометрії залишаються незмінними в колекції.

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> accepts two input geometries
uk: <emphasis role="bold">Варіант 1:</emphasis> приймає дві вхідні геометрії

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> accepts an array of geometries
uk: <emphasis role="bold">Варіант 2:</emphasis> приймає масив геометрій

note: Tag: para
en: <emphasis role="bold">Variant 3:</emphasis> aggregate function accepting a rowset of geometries.
uk: <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).
uk: Якщо будь-яка з вхідних геометрій є колекцією (Multi* або GeometryCollection), ST_Collect повертає GeometryCollection (оскільки це єдиний тип, який може містити вкладені колекції). Щоб цього уникнути, використовуйте <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.
uk: 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.
uk: Доступність: 1.4.0 — додано ST_Collect(geomarray). ST_Collect було вдосконалено для швидшої обробки більшої кількості геометрій.

note: Tag: title
en: Examples - Two-input variant
uk: Приклади - Варіант з двома входами

note: Tag: para
en: Collect 2D points.
uk: Збір 2D точок.

note: Tag: para
en: Collect 3D points.
uk: Збір 3D-точок.

note: Tag: para
en: Collect curves.
uk: Збір кривих.

note: Tag: title
en: Examples - Array variant
uk: Приклади - Варіант масиву

note: Tag: para
en: Using an array constructor for a subquery.
uk: Використання конструктора масиву для підзапиту.

note: Tag: para
en: Using an array constructor for values.
uk: Використання конструктора масиву для значень.

note: Tag: title
en: Examples - Aggregate variant
uk: Приклади - Агрегований варіант

note: Tag: para
en: Creating multiple collections by grouping geometries in a table.
uk: Створення декількох колекцій шляхом групування геометрій у таблиці.

note: Tag: refpurpose
en: <refpurpose>Creates a LineString from a MultiPoint geometry.</refpurpose>
uk: <refpurpose>Створює LineString з геометрії MultiPoint.</refpurpose>

note: Tag: para
en: <para>Creates a LineString from a MultiPoint geometry.</para>
uk: <para>Створює LineString з геометрії MultiPoint.</para>

note: Tag: para
en: Use <xref linkend="ST_MakeLine"/> to create lines from Point or LineString inputs.
uk: Використовуйте <xref linkend="ST_MakeLine"/> для створення ліній з вхідних даних Point або LineString.

note: Tag: para
en: Create a 3D line string from a 3D MultiPoint
uk: Створити 3D лінію з 3D MultiPoint

note: Tag: refpurpose
en: Creates a rectangular Polygon from minimum and maximum coordinates.
uk: Створює прямокутний полігон з мінімальних і максимальних координат.

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.
uk: Створює прямокутний полігон з мінімальних і максимальних значень для X і Y. Вхідні значення повинні бути в просторовій системі координат, визначеній SRID. Якщо SRID не вказано, використовується невідома просторова система координат (SRID 0).

note: Tag: para
en: Availability: 1.5
uk: Доступність: 1.5

note: Tag: para
en: Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was introduced.
uk: Покращено: 2.0: Додано можливість вказати конверт без вказання SRID.

note: Tag: title
en: Example: Building a bounding box polygon
uk: Приклад: Побудова полігону обмежувальної рамки

note: Tag: refpurpose
en: Creates a LineString from Point, MultiPoint, or LineString geometries.
uk: Створює LineString з геометрій Point, MultiPoint або LineString.

note: Tag: para
en: Creates a LineString containing the points of Point, MultiPoint, or LineString geometries. Other geometry types cause an error.
uk: Створює об'єкт LineString, що містить точки геометрій Point, MultiPoint або LineString. Інші типи геометрії спричиняють помилку.

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.
uk: <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.
uk: Повторювані вузли на початку вхідних рядків LineStrings об'єднуються в одну точку. Повторювані точки у вхідних даних Point і MultiPoint не об'єднуються. <xref linkend="ST_RemoveRepeatedPoints"/>можна використовувати для об'єднання повторюваних точок з вихідної лінії.

note: Tag: para
en: Availability: 2.3.0 - Support for MultiPoint input elements was introduced
uk: Доступність: 2.3.0 — додано підтримку елементів введення MultiPoint

note: Tag: para
en: Availability: 2.0.0 - Support for LineString input elements was introduced
uk: Доступність: 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.
uk: Доступність: 1.4.0 — додано ST_MakeLine(geomarray). Агрегатні функції ST_MakeLine було вдосконалено для швидшої обробки більшої кількості точок.

note: Tag: title
en: Examples: Two-input variant
uk: Приклади: Варіант з двома входами

note: Tag: para
en: Create a line composed of two points.
uk: Створити лінію, що складається з двох точок.

note: Tag: para
en: Create a 3D line from two 3D points.
uk: Створити 3D лінію з двох 3D точок.

note: Tag: para
en: Create a line from two disjoint LineStrings.
uk: Створити лінію з двох роз'єднаних LineStrings.

note: Tag: title
en: Examples: Array variant
uk: Приклади: Варіант масиву

note: Tag: para
en: Create a line from an array formed by a subquery with ordering.
uk: Створити лінію з масиву, сформованого підзапитом із сортуванням.

note: Tag: para
en: Create a 3D line from an array of 3D points
uk: Створити 3D лінію з масиву 3D точок

note: Tag: title
en: Examples: Aggregate variant
uk: Приклади: Агрегований варіант

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.
uk: У цьому прикладі запитуються послідовності точок GPS за часом із набору треків і створюється один запис для кожного треку. Результатом є геометрії LineStrings, що складаються з точок треку GPS у порядку руху.

note: Tag: para
en: Using aggregate <varname>ORDER BY</varname> provides a correctly-ordered LineString.
uk: Використання агрегату <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.
uk: До PostgreSQL 9 можна було використовувати сортування в підзапиті. Однак іноді план запиту може не дотримуватися порядку підзапиту.

note: Tag: refpurpose
en: Creates a 2D, 3DZ or 4D Point.
uk: Створює 2D, 3DZ або 4D точку.

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.
uk: Створює геометрію точки 2D XY, 3D XYZ або 4D XYZM. Використовуйте <xref linkend="ST_MakePointM"/>, щоб створити точки з координатами XYM.

note: Tag: para
en: Use <xref linkend="ST_SetSRID"/> to specify a SRID for the created point.
uk: Використовуйте <xref linkend="ST_SetSRID"/>, щоб вказати SRID для створеної точки.

note: Tag: para
en: While not OGC-compliant, <varname>ST_MakePoint</varname> is faster than <xref linkend="ST_GeomFromText"/> and <xref linkend="ST_PointFromText"/>. It is also easier to use for numeric coordinate values.
uk: Хоча <varname>ST_MakePoint</varname> не відповідає стандарту OGC, він працює швидше, ніж <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
uk: Для геодезичних координат <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.
uk: Функції <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.
uk: Створює точку з значень 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.
uk: Створює точку з координатами X, Y та M (вимірювання). Використовуйте <xref linkend="ST_MakePoint"/>, щоб створити точки з координатами XY, XYZ або XYZM.

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.
uk: Функції <xref linkend="ST_PointM"/> та <xref linkend="ST_PointZM"/> можна використовувати для створення точок із значенням M та заданим SRID.

note: Tag: para
en: is used for text output because <xref linkend="ST_AsText"/> does not support M values.
uk: використовується для виведення тексту, оскільки <xref linkend="ST_AsText"/>не підтримує значення M.

note: Tag: para
en: Create point with unknown SRID.
uk: Створити точку з невідомим SRID.

note: Tag: para
en: Create point with a measure in the WGS 84 geodetic coordinate system.
uk: Створити точку з виміром у геодезичній системі координат WGS 84.

note: Tag: para
en: Get measure of created point.
uk: Отримати розмір створеної точки.

note: Tag: refpurpose
en: Creates a Polygon from a shell and optional list of holes.
uk: Створює полігон з оболонки та опціонального списку отворів.

note: Tag: para
en: Creates a Polygon formed by the given shell and optional array of holes. Input geometries must be closed LineStrings (rings).
uk: Створює полігон, утворений заданою оболонкою та опціональним масивом отворів. Вхідні геометрії повинні бути закритими лініями (кільцями).

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> Accepts one shell LineString.
uk: <emphasis role="bold">Варіант 1:</emphasis> Приймає оболонку LineString.

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.
uk: <emphasis role="bold">Варіант 2:</emphasis> Приймає оболонку LineString та масив внутрішніх (діркових) LineStrings. Масив геометрії можна побудувати за допомогою конструкцій 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.
uk: Ця функція не приймає MultiLineStrings. Використовуйте <xref linkend="ST_LineMerge"/>для створення LineString або <xref linkend="ST_Dump"/>для вилучення LineStrings.

note: Tag: title
en: Examples: Single input variant
uk: Приклади: Варіант з одним входом

note: Tag: para
en: Create a Polygon from a 2D LineString.
uk: Створити полігон з 2D LineString.

note: Tag: para
en: Create a Polygon from an open LineString, using <xref linkend="ST_StartPoint"/> and <xref linkend="ST_AddPoint"/> to close it.
uk: Створіть полігон з відкритої лінії, використовуючи <xref linkend="ST_StartPoint"/>та <xref linkend="ST_AddPoint"/>для його закриття.

note: Tag: para
en: Create a Polygon from a 3D LineString
uk: Створіть полігон із 3D-лінії

note: Tag: para
en: Create a Polygon from a LineString with measures
uk: Створює полігон з лінії з вимірами

note: Tag: title
en: Examples: Outer shell with inner holes variant
uk: Приклади: Зовнішня оболонка з внутрішніми отворами

note: Tag: para
en: Create a donut Polygon with an extra hole
uk: Створити полігон у формі пончика з додатковим отвором

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.
uk: Створити набір меж провінцій з отворами, що позначають озера. Вхідними даними є таблиця полігонів/мультиполігонів провінцій та таблиця лінійних об'єктів, що позначають водойми. Лінії, що утворюють озера, визначаються за допомогою <xref linkend="ST_IsClosed"/>. Лінії провінцій витягуються за допомогою <xref linkend="ST_Boundary"/>. Відповідно до вимог <code>ST_MakePolygon</code>, межа примусово перетворюється на єдину лінію за допомогою <xref linkend="ST_LineMerge"/>. (Однак, зверніть увагу, що якщо провінція має більше одного регіону або має острови, це призведе до створення недійсного полігону.) Використання 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.
uk: Конструкція CASE використовується, оскільки передача нульового масиву в ST_MakePolygon призводить до повернення значення NULL.

note: Tag: para
en: Another technique is to utilize a correlated subquery and the ARRAY() constructor that converts a row set to an array.
uk: Інший метод полягає у використанні корельованого підзапиту та конструктора ARRAY(), який перетворює набір рядків у масив.

note: Tag: refpurpose
en: Creates a Point with X, Y and SRID values.
uk: Створює точку із значеннями 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.
uk: Повертає точку з заданими значеннями координат X та Y. Це еквівалент SQL-MM для <xref linkend="ST_MakePoint"/>, який приймає тільки X та Y.

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.
uk: Покращено: 3.2.0 Додано srid як додатковий опціональний аргумент. Старіші версії вимагають поєднання з ST_SetSRID для позначення srid на геометрії.

note: Tag: title
en: Examples: Geometry
uk: Приклади: Геометрія

note: Tag: para
en: Creating a point with SRID specified:
uk: Створення точки із зазначеним SRID:

note: Tag: para
en: Alternative way of specifying SRID:
uk: Альтернативний спосіб вказати SRID:

note: Tag: title
en: Examples: Geography
uk: Приклади: Географія

note: Tag: para
en: Create <link linkend="PostGIS_Geography">geography</link> points using the <varname>::</varname> cast syntax:
uk: Створіть точки <link linkend="PostGIS_Geography">географії</link> за допомогою синтаксису перетворення <varname>::</varname>:

note: Tag: para
en: Pre-PostGIS 3.2 code, using <varname>CAST</varname>:
uk: Код до 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).
uk: Якщо координати точки не знаходяться в геодезичній системі координат (такій як WGS84), то перед перенесенням в географічну систему їх необхідно перепроектувати. У цьому прикладі точка в системі координат Pennsylvania State Plane feet (SRID 2273) перепроектована в систему WGS84 (SRID 4326).

note: Tag: refpurpose
en: Creates a Point with X, Y, Z and SRID values.
uk: Створює точку з координатами 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.
uk: Повертає точку з заданими значеннями координат X, Y і Z, а також, за бажанням, номер SRID.

note: Tag: refpurpose
en: Creates a Point with X, Y, M and SRID values.
uk: Створює точку з значеннями 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.
uk: Повертає точку з заданими значеннями координат X, Y і M, а також, за бажанням, номер SRID.

note: Tag: refpurpose
en: Creates a Point with X, Y, Z, M and SRID values.
uk: Створює точку з значеннями 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.
uk: Повертає точку з заданими значеннями координат X, Y, Z і M, а також, за бажанням, номер SRID.

note: Tag: refpurpose
en: Creates a Polygon from a LineString with a specified SRID.
uk: Створює полігон з LineString із заданим SRID.

note: Tag: para
en: Returns a polygon built from the given LineString and sets the spatial reference system from the <varname>srid</varname>.
uk: Повертає полігон, побудований з заданого LineString, і встановлює систему просторових координат з <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.
uk: 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"/>.
uk: Для створення полігонів з отворами використовуйте <xref linkend="ST_MakePolygon"/>Варіант 2, а потім <xref linkend="ST_SetSRID"/>.

note: Tag: para
en: Create a 2D polygon.
uk: Створити 2D полігон.

note: Tag: para
en: Create a 3D polygon.
uk: Створити 3D полігон.

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>.
uk: Створює прямокутний полігон у <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</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.
uk: Створює прямокутний полігон, що визначає розмір плитки в <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">системі плиток XYZ</link>. Плитка визначається рівнем масштабування Z та індексом XY плитки в сітці на цьому рівні. Може використовуватися для визначення меж плитки, необхідних для <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.
uk: За замовчуванням контур плитки знаходиться в системі координат <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857) з використанням стандартного діапазону системи Web Mercator (-20037508.342789, 20037508.342789). Це найпоширеніша система координат, що використовується для плиток MVT. Додатковий параметр <varname>bounds</varname> можна використовувати для створення плиток у будь-якій системі координат. Це геометрія, що має SRID і розмір квадрата "Рівень масштабування нуль", в якому вписана система плиток 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"/>.
uk: Додатковий параметр <varname>margin</varname> можна використовувати для розширення плитки на заданий відсоток. Наприклад, <varname>margin=0.125</varname> розширює плитку на 12,5%, що еквівалентно buffer=512, коли розмір плитки становить 4096, як використовується в <xref linkend="ST_AsMVTGeom"/>. Це корисно для створення буфера плиток, щоб включити дані, які лежать за межами видимої області плитки, але наявність яких впливає на візуалізацію плитки. Наприклад, назва міста (точка) може бути поблизу краю плитки, тому її мітка повинна бути візуалізована на двох плитках, навіть якщо точка розташована у видимій області лише однієї плитки. Використання розширених плиток у запиті дозволить включити точку міста в обидві плитки. Для зменшення плитки використовуйте від'ємне значення. Значення менше -0.5 заборонені, оскільки це призведе до повного видалення плитки. Не вказуйте поле при використанні з <varname>ST_AsMVTGeom</varname>. Дивіться приклад для <xref linkend="ST_AsMVT"/>.

note: Tag: para
en: Enhanced: 3.1.0 Added margin parameter.
uk: Покращено: 3.1.0 Додано параметр поля.

note: Tag: para
en: Availability: 3.0.0
uk: Доступність: 3.0.0

note: Tag: title
en: Example: Building a tile envelope
uk: Приклад: Побудова конверта плитки

note: Tag: refpurpose
en: Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument.
uk: Повертає набір шестикутників та індексів комірок, які повністю покривають межі аргументу геометрії.

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.
uk: Починається з концепції шестикутної мозаїки площини. (Це не шестикутна мозаїка земної кулі, це не схема мозаїки <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.
uk: 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.
uk: Подвоєння або потроєння розміру ребра шестикутника створює нову батьківську мозаїку, яка відповідає вихідній мозаїці. На жаль, неможливо створити батьківську мозаїку з шестикутників, в яку ідеально вписуються дочірні плитки.

note: Tag: para
en: Availability: 3.1.0
uk: Доступність: 3.1.0

note: Tag: title
en: Example: Counting points in hexagons
uk: Приклад: Підрахунок точок у шестикутниках

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.
uk: Щоб зробити підсумок точок на шестикутній мозаїці, створіть шестикутну сітку, використовуючи межі точок як обмеження, а потім просторово з'єднайте її з цією сіткою.

note: Tag: title
en: Example: Generating hex coverage of polygons
uk: Приклад: Створення шестнадцяткового покриття полігонів

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.
uk: Якщо ми створимо набір шестикутників для кожної межі полігону і відфільтруємо ті, що не перетинаються з їх шестикутниками, ми отримаємо мозаїку для кожного полігону.

note: Tag: para
en: Tiling states results in a hexagon coverage of each state, and multiple hexagons overlapping at the borders between states.
uk: У результаті мозаїчного покриття кожен стан покривається шестикутником, а на межі між станами утворюються перекриваються шестикутники.

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.
uk: Ключове слово 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.
uk: Повертає один шестикутник, використовуючи заданий розмір ребра та координати комірки в просторі шестикутної сітки.

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.
uk: Використовує ту саму концепцію шестикутної мозаїки, що й <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.
uk: Шестикутники генеруються без заданого SRID, тому використовуйте <xref linkend="ST_SetSRID"/>, щоб задати SRID відповідно до ваших очікувань.

note: Tag: title
en: Example: Creating a hexagon at the origin
uk: Приклад: Створення шестикутника в початку координат

note: Tag: refpurpose
en: Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument.
uk: Повертає набір квадратів сітки та індексів комірок, які повністю покривають межі аргументу геометрії.

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.
uk: Починається з концепції квадратного покриття площини. Для заданої плоскої SRS і заданого розміру ребра, починаючи від початку SRS, існує одне унікальне квадратне покриття площини, Tiling(SRS, Size). Ця функція відповідає на питання: які сітки в заданому Tiling(SRS, Size) перекриваються з заданими межами.

note: Tag: para
en: The SRS for the output squares is the SRS provided by the bounds geometry.
uk: 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.
uk: Подвоєння або розмір краю квадрата створює нову батьківську мозаїку, яка ідеально підходить до оригінальної мозаїки. Стандартні веб-карти в проекції Меркатора — це просто квадратні сітки, що є степенями числа два в площині Меркатора.

note: Tag: title
en: Example: Generating a 1 degree grid for a country
uk: Приклад: Створення сітки з кроком 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.
uk: Сітка заповнить всю територію країни, тому якщо вам потрібні лише квадрати, що торкаються країни, вам доведеться потім відфільтрувати їх за допомогою ST_Intersects.

note: Tag: title
en: Example: Counting points in squares (using single chopped grid)
uk: Приклад: Підрахунок очок у квадратах (з використанням одинарної сітки)

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.
uk: Щоб зробити підсумок точок на квадратній мозаїці, створіть квадратну сітку, використовуючи межі точок як обмеження, а потім просторово з'єднайте її з цією сіткою. Зверніть увагу, що приблизна площа може відрізнятися від фактичної, тому будьте обережні і, як мінімум, переконайтеся, що ви проаналізували свою таблицю.

note: Tag: title
en: Example: Counting points in squares using set of grid per point
uk: Приклад: Підрахунок точок у квадратах за допомогою набору сіток для кожної точки

note: Tag: para
en: This yields the same result as the first example but will be slower for a large number of points
uk: Це дає той самий результат, що й у першому прикладі, але буде повільніше для великої кількості точок

note: Tag: refpurpose
en: Returns a single square, using the provided edge size and cell coordinate within the square grid space.
uk: Повертає один квадрат, використовуючи заданий розмір сторони та координати комірки в просторі квадратної сітки.

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.
uk: Використовує ту саму концепцію квадратної мозаїки, що й <xref linkend="ST_SquareGrid"/>, але створює лише один квадрат у бажаних координатах комірки. За бажанням можна налаштувати координати початку мозаїки, за замовчуванням початок знаходиться в точці 0,0.

note: Tag: para
en: Squares are generated with the SRID of the given origin. Use <xref linkend="ST_SetSRID"/> to set the SRID if the given origin has an unknown SRID (as is the case by default).
uk: Квадрати генеруються з SRID заданого початку координат. Використовуйте <xref linkend="ST_SetSRID"/>, щоб встановити SRID, якщо заданий початок координат має невідомий SRID (як це відбувається за замовчуванням).

note: Tag: title
en: Example: Creating a square at the origin
uk: Приклад: Створення квадрата в початку координат

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.
uk: Повертає введені літери, відтворені як геометрія, з початковою позицією за замовчуванням в початку координат і висотою тексту за замовчуванням 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.
uk: Використовує вбудований шрифт для відображення рядка як мультиполігональної геометрії. За замовчуванням висота тексту становить 100,0, відстань від нижньої частини нижнього виступу до верхньої частини великої літери. За замовчуванням початкова позиція розміщує початок базової лінії в точці початку координат. Для заміни шрифту потрібно передати карту json, де ключем є символ, а TWKB, закодований у base64, — форма шрифту, висота шрифтів становить 1000 одиниць від нижньої частини нижнього виступу до верхньої частини великої літери.

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.
uk: Текст за замовчуванням генерується в точці початку координат, тому щоб змінити його положення та розмір, спочатку застосуйте функцію <code>ST_Scale</code>, а потім функцію <code>ST_Translate</code>.

note: Tag: title
en: Example: Generating the word 'Yo'
uk: Приклад: Створення слова "Yo"

note: Tag: para
en: Letters generated by ST_Letters
uk: Листи, створені ST_Letters

note: Tag: title
en: Example: Scaling and moving words
uk: Приклад: Масштабування та переміщення слів

note: Tag: title
en: Coverages
uk: Покриття

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.
uk: Ці функції працюють з наборами полігональної геометрії, що утворюють "неявні покриття". Щоб утворити дійсне покриття, полігони не повинні перекриватися, а вершини суміжних ребер повинні збігатися. Покриття швидко обробляються і можуть оброблятися за допомогою віконних функцій, які зберігають топологію покриття всередині розділу вікна при зміні ребер.

note: Tag: refpurpose
en: Window function that finds locations where polygons fail to form a valid coverage.
uk: Віконна функція, яка знаходить місця, де полігони не утворюють дійсного покриття.

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.
uk: Віконна функція, яка перевіряє, чи полігони у вікні утворюють дійсне полігональне покриття. Вона повертає лінійні індикатори, що показують розташування недійсних країв (якщо такі є) у кожному полігоні.

note: Tag: para
en: A set of valid polygons is a valid coverage if the following conditions hold:
uk: Набір дійсних полігонів є дійсним покриттям, якщо виконуються такі умови:

note: Tag: para
en: <emphasis role="bold">Non-overlapping</emphasis> - polygons do not overlap (their interiors do not intersect)
uk: <emphasis role="bold">Неперекриваються</emphasis> - полігони не перекриваються (їх внутрішні частини не перетинаються)

note: Tag: para
en: <emphasis role="bold">Edge-Matched</emphasis> - vertices along shared edges are identical
uk: <emphasis role="bold">Edge-Matched</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.
uk: Як віконна функція, для кожного вхідного полігону повертається значення. Для полігонів, які порушують одну або кілька умов дійсності, значенням, що повертається, є 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.
uk: Умови дозволяють дійсному покриттю містити отвори (проміжки між полігонами), якщо сусідні полігони збігаються по краях. Однак дуже вузькі проміжки часто є небажаними. Якщо параметр <parameter>tolerance</parameter> задано з відстанню, відмінною від нуля, краї, що утворюють вужчі проміжки, також будуть повернуті як недійсні.

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"/>.
uk: Полігони, що перевіряються на валідність покриття, також повинні бути валідними геометріями. Це можна перевірити за допомогою <xref linkend="ST_IsValid"/>.

note: Tag: para
en: Requires GEOS &gt;= 3.12.0
uk: Потрібна версія GEOS &gt;= 3.12.0

note: Tag: para
en: Invalid edges caused by overlap and non-matching vertices
uk: Недійсні ребра, спричинені перекриттям і невідповідністю вершин

note: Tag: refpurpose
en: Window function that simplifies the edges of a polygonal coverage.
uk: Віконна функція, яка спрощує краї полігонального покриття.

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.
uk: Віконна функція, яка спрощує краї полігонів у полігональному покритті. Спрощення зберігає топологію покриття. Це означає, що спрощені вихідні полігони є сумісними вздовж спільних країв і все ще утворюють дійсне покриття.

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.
uk: Спрощення використовує варіант алгоритму <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam–Whyatt</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.
uk: Щоб спростити тільки "внутрішні" краї покриття (ті, що є спільними для двох полігонів), встановіть параметр <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.
uk: Якщо вхідні дані не є дійсним покриттям, у вихідних даних можуть з'явитися несподівані артефакти (наприклад, перетини меж або розділені межі, які здавалися спільними). Використовуйте <xref linkend="ST_CoverageInvalidEdges"/>, щоб визначити, чи є покриття дійсним.

note: Tag: para
en: Input coverage
uk: Покриття вхідних даних

note: Tag: para
en: Simplified coverage
uk: Спрощене покриття

note: Tag: refpurpose
en: Computes the union of a set of polygons forming a coverage by removing shared edges.
uk: Обчислює об'єднання набору полігонів, що утворюють покриття, видаляючи спільні ребра.

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.
uk: Агрегуюча функція, яка об'єднує набір полігонів, що утворюють полігональне покриття. Результатом є полігональна геометрія, що покриває ту саму площу, що й покриття. Ця функція дає той самий результат, що й <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.
uk: Якщо вхідні дані не є дійсним покриттям, у вихідних даних можуть з'явитися несподівані артефакти (наприклад, не об'єднані або перекриваються полігони). Використовуйте <xref linkend="ST_CoverageInvalidEdges"/>, щоб визначити, чи є покриття дійсним.

note: Tag: para
en: Availability: 3.4.0 - requires GEOS &gt;= 3.8.0
uk: Доступність: 3.4.0 - вимагає GEOS &gt;= 3.8.0

note: Tag: para
en: Union result
uk: Результат об'єднання

note: Tag: refpurpose
en: Computes a clean (edge matched, non-overlapping, gap-cleared) polygonal coverage, given a non-clean input.
uk: Обчислює чисте (збіжні краї, без перекриттів, без прогалин) полігональне покриття, задане нечистим вхідним даними.

note: Tag: para
en: A window function which alters the edges of a polygonal coverage to ensure that none of the polygons overlap, that small gaps are snapped away, and that all shared edges are exactly identical. The result is a clean coverage that will pass validation tests like <xref linkend="ST_CoverageInvalidEdges"/>
uk: Віконна функція, яка змінює краї полігонального покриття, щоб жоден з полігонів не перекривався, невеликі проміжки були видалені, а всі спільні краї були абсолютно ідентичними. Результатом є чисте покриття, яке пройде тести валідації, такі як <xref linkend="ST_CoverageInvalidEdges"/>

note: Tag: para
en: The <parameter>gapMaximumWidth</parameter> controls the cleaning of gaps between polygons. Gaps smaller than this tolerance will be closed.
uk: Параметр <parameter>gapMaximumWidth</parameter> контролює очищення проміжків між полігонами. Проміжки, менші за цей допуск, будуть закриті.

note: Tag: para
en: The <parameter>snappingDistance</parameter> controls the node snapping step, when nearby vertices are snapped together. The default setting (-1) applies an automatic snapping distance based on an analysis of the input. Set to 0.0 to turn off all snapping.
uk: Параметр <parameter>snappingDistance</parameter> контролює крок прив'язки вузлів, коли сусідні вершини прив'язуються одна до одної. За замовчуванням (-1) застосовується автоматична відстань прив'язки на основі аналізу вхідних даних. Встановіть значення 0,0, щоб вимкнути всі прив'язки.

note: Tag: para
en: The <parameter>overlapMergeStrategy</parameter> controls the algorithm used to determine which neighboring polygons to merge overlapping areas into.
uk: Параметр <parameter>overlapMergeStrategy</parameter> контролює алгоритм, що використовується для визначення сусідніх полігонів, в які слід об'єднати перекриваються області.

note: Tag: para
en: <code>MERGE_LONGEST_BORDER</code> chooses polygon with longest common border
uk: <code>MERGE_LONGEST_BORDER</code> вибирає полігон з найдовшою спільною межею

note: Tag: para
en: <code>MERGE_MAX_AREA</code> chooses polygon with maximum area
uk: <code>MERGE_MAX_AREA</code> вибирає полігон з максимальною площею

note: Tag: para
en: <code>MERGE_MIN_AREA</code> chooses polygon with minimum area
uk: <code>MERGE_MIN_AREA</code> вибирає полігон з мінімальною площею

note: Tag: para
en: <code>MERGE_MIN_INDEX</code> chooses polygon with smallest input index
uk: <code>MERGE_MIN_INDEX</code> вибирає полігон з найменшим індексом вхідних даних

note: Tag: para
en: Availability: 3.6.0 - requires GEOS &gt;= 3.14.0
uk: Доступність: 3.6.0 - вимагає GEOS &gt;= 3.14.0

note: Tag: title
en: Geometry Editors
uk: Редактори геометрії

note: Tag: para
en: These functions create modified geometries by changing type, structure or vertices.
uk: Ці функції створюють модифіковані геометрії шляхом зміни типу, структури або вершин.

note: Tag: refpurpose
en: Add a point to a LineString.
uk: Додати точку до LineString.

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.
uk: Додає точку до LineString перед індексом <parameter>position</parameter> (використовуючи індекс, що починається з 0). Якщо параметр <parameter>position</parameter> пропущено або дорівнює -1, точка додається в кінець LineString.

note: Tag: para
en: Add a point to the end of a 3D line
uk: Додати точку в кінець 3D лінії

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.
uk: Гарантуйте, що всі лінії в таблиці закриті, додавши початкову точку кожної лінії до кінця лінії тільки для тих, які не закриті.

note: Tag: refpurpose
en: Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
uk: За заданою колекцією геометрій повертає мультигеометрію, що містить тільки елементи заданого типу.

note: Tag: para
en: Given a geometry collection, returns a homogeneous multi-geometry.
uk: За заданою колекцією геометрій повертає однорідну мультигеометрію.

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.
uk: Якщо <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:
uk: Якщо вказано <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"/>.
uk: Для вхідних даних атомарної геометрії геометрія повертається без змін, якщо тип вхідних даних відповідає запитуваному типу. В іншому випадку результатом є геометрія EMPTY заданого типу. За необхідності їх можна перетворити на мультигеометрії за допомогою <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"/>.
uk: Результати MultiPolygon не перевіряються на валідність. Якщо компоненти полігону є суміжними або перекриваються, результат буде недійсним. (Наприклад, це може статися при застосуванні цієї функції до результату <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.
uk: До версії 1.5.3 ця функція повертала атомарні вхідні дані без змін, незалежно від типу. У версії 1.5.3 невідповідні одиничні геометрії повертали результат NULL. У версії 2.0.0 невідповідні одиничні геометрії повертають результат EMPTY запитуваного типу.

note: Tag: para
en: Extract highest-dimension type:
uk: Витяг типу найвищого виміру:

note: Tag: para
en: Extract points (type 1 == POINT):
uk: Витягнути точки (тип 1 == POINT):

note: Tag: para
en: Extract lines (type 2 == LINESTRING):
uk: Витягнути лінії (тип 2 == LINESTRING):

note: Tag: refpurpose
en: Returns the simplest representation of a geometry collection.
uk: Повертає найпростіше представлення колекції геометрії.

note: Tag: para
en: Given a geometry collection, returns the "simplest" representation of the contents.
uk: За заданою колекцією геометрії повертає "найпростіше" представлення вмісту.

note: Tag: para
en: Homogeneous (uniform) collections are returned as the appropriate multi-geometry.
uk: Однорідні (однотипні) колекції повертаються як відповідна мультигеометрія.

note: Tag: para
en: Heterogeneous (mixed) collections are flattened into a single GeometryCollection.
uk: Гетерогенні (змішані) колекції об'єднуються в одну колекцію GeometryCollection.

note: Tag: para
en: Collections containing a single atomic element are returned as that element.
uk: Колекції, що містять один атомарний елемент, повертаються як цей елемент.

note: Tag: para
en: Atomic geometries are returned unchanged. If required, these can be converted to a multi-geometry using <xref linkend="ST_Multi"/>.
uk: Атомарні геометрії повертаються без змін. При необхідності їх можна перетворити на мультигеометрії за допомогою <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"/>.
uk: Ця функція не гарантує, що результат є дійсним. Зокрема, колекція, що містить сусідні або перекриваються полігони, створить недійсний MultiPolygon. Цю ситуацію можна перевірити за допомогою <xref linkend="ST_IsValid"/> і виправити за допомогою <xref linkend="ST_MakeValid"/>.

note: Tag: para
en: Single-element collection converted to an atomic geometry
uk: Одноелементна колекція, перетворена в атомарну геометрію

note: Tag: para
en: Nested single-element collection converted to an atomic geometry:
uk: Вкладена колекція з одним елементом, перетворена в атомарну геометрію:

note: Tag: para
en: Collection converted to a multi-geometry:
uk: Колекція перетворена на багатогеометрію:

note: Tag: para
en: Nested heterogeneous collection flattened to a GeometryCollection:
uk: Вкладені неоднорідні колекції, сплощені до GeometryCollection:

note: Tag: para
en: Collection of Polygons converted to an (invalid) MultiPolygon:
uk: Колекція полігонів, перетворених у (недійсний) MultiPolygon:

note: Tag: refpurpose
en: Converts a geometry containing curves to a linear geometry.
uk: Перетворює геометрію, що містить криві, на лінійну геометрію.

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
uk: Перетворює CIRCULAR STRING у звичайний 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).
uk: Перетворює задану геометрію в лінійну геометрію. Кожна крива геометрія або сегмент перетворюється в лінійне наближення з використанням заданого `допуску` та опцій (32 сегменти на квадрант і жодних опцій за замовчуванням).

note: Tag: para
en: The 'tolerance_type' argument determines interpretation of the `tolerance` argument. It can take the following values:
uk: Аргумент "tolerance_type" визначає інтерпретацію аргументу "tolerance". Він може приймати наступні значення:

note: Tag: para
en: 0 (default): Tolerance is max segments per quadrant.
uk: 0 (за замовчуванням): Допустиме відхилення — максимальна кількість сегментів на квадрант.

note: Tag: para
en: 1: Tolerance is max-deviation of line from curve, in source units.
uk: 1: Допуск — це максимальне відхилення лінії від кривої в одиницях джерела.

note: Tag: para
en: 2: Tolerance is max-angle, in radians, between generating radii.
uk: 2: Допуск — це максимальний кут, виражений в радіанах, між радіусами, що утворюють.

note: Tag: para
en: The 'flags' argument is a bitfield. 0 by default. Supported bits are:
uk: Аргумент "flags" є бітовим полем. За замовчуванням має значення 0. Підтримуються такі біти:

note: Tag: para
en: 1: Symmetric (orientation independent) output.
uk: 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.
uk: 2: Зберігає кут, запобігає зменшенню кутів (довжини сегментів) під час створення симетричного виводу. Не діє, якщо прапор Symmetric вимкнено.

note: Tag: para
en: Availability: 1.3.0
uk: Доступність: 1.3.0

note: Tag: para
en: Enhanced: 2.4.0 added support for max-deviation and max-angle tolerance, and for symmetric output.
uk: Покращено: у версії 2.4.0 додано підтримку максимального відхилення та максимального кута допуску, а також симетричного виводу.

note: Tag: para
en: Enhanced: 3.0.0 implemented a minimum number of segments per linearized arc to prevent topological collapse.
uk: Покращено: у версії 3.0.0 впроваджено мінімальну кількість сегментів на лінійну дугу, щоб запобігти топологічному колапсу.

note: Tag: refpurpose
en: Change start point of a closed LineString.
uk: Змінити початкову точку замкнутої лінії LineString.

note: Tag: para
en: Changes the start/end point of a closed LineString to the given vertex <parameter>point</parameter>.
uk: Змінює початкову/кінцеву точку замкнутої лінії LineString на задану вершину <parameter>point</parameter>.

note: Tag: para
en: Make e closed line start at its 3rd vertex
uk: Зробіть закриту лінію, починаючи з її третьої вершини

note: Tag: refpurpose
en: Returns a version of a geometry with X and Y axis flipped.
uk: Повертає версію геометрії з перевернутими осями 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).
uk: Повертає версію заданої геометрії з перевернутими осями X та Y. Корисно для виправлення геометрій, які містять координати, виражені у вигляді широти/довготи (Y, X).

note: Tag: title
en: Example
uk: Приклад

note: Tag: refpurpose
en: Force the geometries into a "2-dimensional mode".
uk: Примусово переведіть геометрії в "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).
uk: Примусово переводить геометрії в "двовимірний режим", щоб усі вихідні представлення мали тільки координати X і Y. Це корисно для виведення даних, сумісних із OGC (оскільки OGC визначає тільки двовимірні геометрії).

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_2D.
uk: Змінено: 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.
uk: Примусово перевести геометрії в режим 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.
uk: Примусово переводить геометрії в режим XYZ. Це псевдонім для ST_Force3DZ. Якщо геометрія не має компонента Z, то додається координата Z <parameter>Zvalue</parameter>.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3D.
uk: Змінено: 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.
uk: Змінено: 3.1.0. Додано підтримку для надання значення Z, відмінного від нуля.

note: Tag: refpurpose
en: Force the geometries into XYZ mode.
uk: Примусово перевести геометрії в режим 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.
uk: Примусово переводить геометрії в режим XYZ. Якщо геометрія не має компонента Z, то додається координата Z <parameter>Zvalue</parameter>.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DZ.
uk: Змінено: 2.1.0. До версії 2.0.x це називалося ST_Force_3DZ.

note: Tag: refpurpose
en: Force the geometries into XYM mode.
uk: Примусово перевести геометрії в режим 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
uk: Примусово переводить геометрії в режим 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.
uk: Змінено: 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.
uk: Змінено: 3.1.0. Додано підтримку для надання значення M, відмінного від нуля.

note: Tag: refpurpose
en: Force the geometries into XYZM mode.
uk: Примусово перевести геометрії в режим 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.
uk: Примусово переводить геометрії в режим XYZM. <parameter>Zvalue</parameter> та <parameter>Mvalue</parameter> додаються для відсутніх розмірів Z та M відповідно.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_4D.
uk: Змінено: 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.
uk: Змінено: 3.1.0. Додано підтримку для надання ненульових значень Z та M.

note: Tag: refpurpose
en: Convert the geometry into a GEOMETRYCOLLECTION.
uk: Перетворити геометрію в GEOMETRYCOLLECTION.

note: Tag: para
en: Converts the geometry into a GEOMETRYCOLLECTION. This is useful for simplifying the WKB representation.
uk: Перетворює геометрію в GEOMETRYCOLLECTION. Це корисно для спрощення представлення 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+
uk: Доступність: 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.
uk: Змінено: 2.1.0. До версії 2.0.x це називалося ST_Force_Collection.

note: Tag: refpurpose
en: Upcast a geometry into its curved type, if applicable.
uk: Перетворити геометрію в її вигнутий тип, якщо це можливо.

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.
uk: Перетворює геометрію в її криве представлення, якщо це можливо: лінії стають складеними кривими, мультилінії стають мультикривими, полігони стають криволінійними полігонами, мультиполігоанми стають багатоповерхневими. Якщо вхідна геометрія вже є кривим представленням, повертається те саме, що і вхідні дані.

note: Tag: refpurpose
en: Orients all exterior rings counter-clockwise and all interior rings clockwise.
uk: Всі зовнішні кільця орієнтуйте проти годинникової стрілки, а всі внутрішні кільця — за годинниковою стрілкою.

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.
uk: Змушує (Мульти)Полігони) використовувати орієнтацію проти годинникової стрілки для зовнішнього кільця та орієнтацію за годинниковою стрілкою для внутрішніх кілець. Неполігональні геометрії повертаються без змін.

note: Tag: refpurpose
en: Orients all exterior rings clockwise and all interior rings counter-clockwise.
uk: Всі зовнішні кільця орієнтуйте за годинниковою стрілкою, а всі внутрішні кільця — проти годинникової стрілки.

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.
uk: Змушує (Мульти)Полігони) використовувати орієнтацію за годинниковою стрілкою для зовнішнього кільця та проти годинникової стрілки для внутрішніх кілець. Неполігональні геометрії повертаються без змін.

note: Tag: refpurpose
en: Force the geometries to use SFS 1.1 geometry types only.
uk: Змусити геометрії використовувати тільки типи геометрії SFS 1.1.

note: Tag: refpurpose
en: Force the orientation of the vertices in a polygon to follow the Right-Hand-Rule.
uk: Примусово встановити орієнтацію вершин полігону відповідно до правила правої руки.

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"/>
uk: Примушує орієнтацію вершин полігону слідувати правилу правої руки, за яким область, обмежена полігоном, знаходиться праворуч від межі. Зокрема, зовнішнє кільце орієнтовано за годинниковою стрілкою, а внутрішні кільця - проти годинникової стрілки. Ця функція є синонімом <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.
uk: Вищезазначене визначення правила правої руки суперечить визначенням, що використовуються в інших контекстах. Щоб уникнути плутанини, рекомендується використовувати ST_ForcePolygonCW.

note: Tag: refpurpose
en: Returns a line extended forwards and backwards by specified distances.
uk: Повертає лінію, розширений вперед і назад на вказані відстані.

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.
uk: Повертає лінію, продовжену вперед і назад шляхом додавання нових початкових (і кінцевих) точок на заданій відстані (відстанях). Відстань, рівна нулю, не додає точку. Допускаються тільки невід'ємні відстані. Напрямок доданих точок визначається першими (і останніми) двома відмінними точками лінії. Повторювані точки ігноруються.

note: Tag: title
en: Example: Extends a line 5 units forward and 6 units backward
uk: Приклад: Продовжує лінію на 5 одиниць вперед і 6 одиниць назад

note: Tag: refpurpose
en: Converts a linear geometry to a curved geometry.
uk: Перетворює лінійну геометрію на криву геометрію.

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.
uk: Перетворює прості LINESTRING/POLYGON в CIRCULAR STRINGs і вигнуті полігони. Зверніть увагу, що для опису вигнутого еквівалента потрібно набагато менше точок.

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.
uk: Якщо вхідні дані LINESTRING/POLYGON недостатньо вигнуті, щоб чітко відобразити криву, функція поверне ту саму вхідну геометрію.

note: Tag: refpurpose
en: Return the geometry as a MULTI* geometry.
uk: Повернути геометрію як геометрію MULTI*.

note: Tag: para
en: Returns the geometry as a MULTI* geometry collection. If the geometry is already a collection, it is returned unchanged.
uk: Повертає геометрію як колекцію геометрії MULTI*. Якщо геометрія вже є колекцією, вона повертається без змін.

note: Tag: refpurpose
en: Return the geometry in its canonical form.
uk: Повернути геометрію в канонічній формі.

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.
uk: Повертає геометрію в нормалізованому/канонічному вигляді. Може змінювати порядок вершин у кільцях полігонів, кільцях у полігоні, елементах у багатогеометричному комплексі.

note: Tag: para
en: Mostly only useful for testing purposes (comparing expected and obtained results).
uk: В основному корисний тільки для тестування (порівняння очікуваних і отриманих результатів).

note: Tag: refpurpose
en: Returns a point projected from a start point by a distance and bearing (azimuth).
uk: Повертає точку, спроектовану від початкової точки на відстань і азимут.

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.
uk: Повертає точку, спроектовану з точки вздовж геодезичної лінії з використанням заданої відстані та азимута (пеленга). Це відоме як пряма геодезична задача.

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.
uk: Двоточкова версія використовує шлях від першої до другої точки для неявного визначення азимута і використовує відстань, як і раніше.

note: Tag: para
en: The distance is given in meters. Negative values are supported.
uk: Відстань вказана в метрах. Підтримуються від'ємні значення.

note: Tag: para
en: The azimuth (also known as heading or bearing) is given in radians. It is measured clockwise from true north.
uk: Азимут (також відомий як курс або пеленг) вимірюється в радіанах. Він вимірюється за годинниковою стрілкою від справжнього півночі.

note: Tag: para
en: North is azimuth zero (0 degrees)
uk: Північ — це азимут нуль (0 градусів)

note: Tag: para
en: East is azimuth &#x03C0;/2 (90 degrees)
uk: Схід — азимут &#x03C0;/2 (90 градусів)

note: Tag: para
en: South is azimuth &#x03C0; (180 degrees)
uk: Південь — азимут &#x03C0; (180 градусів)

note: Tag: para
en: West is azimuth 3&#x03C0;/2 (270 degrees)
uk: Захід знаходиться на азимуті 3&#x03C0;/2 (270 градусів)

note: Tag: para
en: Negative azimuth values and values greater than 2&#x03C0; (360 degrees) are supported.
uk: Підтримуються від'ємні значення азимута та значення, більші за 2&#x03C0; (360 градусів).

note: Tag: para
en: Enhanced: 2.4.0 Allow negative distance and non-normalized azimuth.
uk: Покращено: 2.4.0 Дозволено негативну відстань і ненормалізований азимут.

note: Tag: para
en: Enhanced: 3.4.0 Allow geometry arguments and two-point form omitting azimuth.
uk: Покращено: 3.4.0 Дозволено аргументи геометрії та двоточкову форму з пропуском азимута.

note: Tag: title
en: Example: Projected point at 100,000 meters and bearing 45 degrees
uk: Приклад: Проекційна точка на відстані 100 000 метрів і пеленг 45 градусів

note: Tag: para
en: , <xref linkend="ST_Distance"/>, <link xlink:href="http://www.postgresql.org/docs/current/interactive/functions-math.html">PostgreSQL function radians()</link>
uk: , <xref linkend="ST_Distance"/>, <link xlink:href="http://www.postgresql.org/docs/current/interactive/functions-math.html">Функція PostgreSQL radians()</link>

note: Tag: refpurpose
en: Sets least significant bits of coordinates to zero
uk: Встановлює найменш значущі біти координат у нуль

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.
uk: <code>ST_QuantizeCoordinates</code> визначає кількість бітів (<code>N</code>), необхідних для представлення значення координати з заданою кількістю цифр після десяткової крапки, а потім встановлює всі біти, крім <code>N</code> найстарших, в нуль. Отримане значення координати все одно буде округлено до початкового значення, але його стисливість буде покращено. Це може призвести до значного зменшення використання дискового простору за умови, що стовпець геометрії використовує <link xlink:href="https://www.postgresql.org/docs/current/static/storage-toast.html#STORAGE-TOAST-ONDISK"> стисливий тип зберігання</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.
uk: Координати, отримані за допомогою <code>ST_QuantizeCoordinates</code>, не залежать від геометрії, що містить ці координати, та відносного положення цих координат у геометрії. Як результат, використання цієї функції не впливає на існуючі топологічні відносини між геометріями. Функція може створити недійсну геометрію, якщо її викликати з кількістю цифр, меншою за внутрішню точність геометрії.

note: Tag: para
en: Availability: 2.5.0
uk: Доступність: 2.5.0

note: Tag: title
en: Technical Background
uk: Технічна інформація

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.)
uk: PostGIS зберігає всі значення координат у вигляді цілих чисел з подвійною точністю, які можуть надійно представляти 15 значущих цифр. Однак PostGIS може використовуватися для управління даними, які за своєю суттю мають менше 15 значущих цифр. Прикладом є дані TIGER, які надаються у вигляді географічних координат з точністю до шести цифр після десяткової крапки (отже, потрібно лише дев'ять значущих цифр довготи та вісім значущих цифр широти)

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.
uk: Коли доступно 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 незначущі біти на нуль. Для довгої послідовності координат це створює шаблон блоків послідовних нулів, який 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.
uk: На розмір геометрії на диску потенційно впливає лише <code>ST_QuantizeCoordinates</code>. <xref linkend="ST_MemSize"/>, який повідомляє про використання геометрії в пам'яті, поверне те саме значення незалежно від дискового простору, який використовує геометрія.

note: Tag: refpurpose
en: Remove a point from a linestring.
uk: Видалити точку з лінії.

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.
uk: Видаляє точку з LineString, задавши її індекс (починаючи з 0). Корисно для перетворення замкнутої лінії (кільця) у відкриту лінію.

note: Tag: para
en: Enhanced: 3.2.0
uk: Покращено: 3.2.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
uk: Гарантує, що лінії не будуть закриті, видаляючи кінцеву точку закритих ліній (кільця). Припускає, що геометрична фігура має тип LINESTRING

note: Tag: refpurpose
en: Returns a version of a geometry with duplicate points removed.
uk: Повертає версію геометрії з видаленими дублікатами точок.

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.
uk: Повертає версію заданої геометрії з видаленими дублюючими послідовними точками. Функція обробляє тільки (Multi)LineStrings, (Multi)Polygons і MultiPoints, але її можна викликати з будь-яким типом геометрії. Елементи GeometryCollections обробляються індивідуально. Кінцеві точки LineStrings зберігаються.

note: Tag: para
en: If a non-zero <parameter>tolerance</parameter> parameter is provided, vertices within the tolerance distance of one another are considered to be duplicates. The distance is computed in 2D (XY plane).
uk: Якщо вказано ненульовий параметр <parameter>tolerance</parameter>, вершини, що знаходяться на відстані, яка не перевищує допуск, вважаються дублікатами. Відстань обчислюється у 2D (площина XY).

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Collection elements are processed individually.
uk: <emphasis role="bold">Приклад:</emphasis> Елементи колекції обробляються окремо.

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Repeated point removal with a distance tolerance.
uk: <emphasis role="bold">Приклад:</emphasis> Повторне видалення точок з допуском відстані.

note: Tag: refpurpose
en: Removes points that are irrelevant for rendering a specific rectangular view of a geometry.
uk: Видаляє точки, які не мають значення для візуалізації певного прямокутного виду геометрії.

note: Tag: para
en: Returns a <xref linkend="geometry"/> without points being irrelevant for rendering the geometry within a given rectangular view.
uk: Повертає <xref linkend="geometry"/>без точок, що не мають значення для візуалізації геометрії в заданому прямокутному вікні.

note: Tag: para
en: This function can be used to quickly preprocess geometries that should be rendered only within certain bounds.
uk: Ця функція може бути використана для швидкої попередньої обробки геометрій, які повинні бути відтворені тільки в певних межах.

note: Tag: para
en: Only geometries of type (MULTI)POLYGON and (MULTI)LINESTRING are evaluated. Other geometries keep unchanged.
uk: Оцінюються тільки геометрії типу (MULTI)POLYGON і (MULTI)LINESTRING. Інші геометрії залишаються без змін.

note: Tag: para
en: In contrast to <code>ST_ClipByBox2D()</code> this function
uk: На відміну від <code>ST_ClipByBox2D()</code>, ця функція

note: Tag: para
en: sorts out points without computing new intersection points which avoids rounding errors and usually increases performance,
uk: сортує точки без обчислення нових точок перетину, що дозволяє уникнути помилок округлення і, як правило, підвищує продуктивність,

note: Tag: para
en: returns a geometry with equal or similar point number,
uk: повертає геометрію з однаковою або схожою кількістю точок,

note: Tag: para
en: leads to the same rendering result within the specified view, and
uk: призводить до однакового результату візуалізації в межах заданого виду, і

note: Tag: para
en: may introduce self-intersections which would make the resulting geometry invalid (see example below).
uk: може призвести до самоперетину, що зробить отриману геометрію недійсною (див. приклад нижче).

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.
uk: Якщо <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"/>.
uk: Для полігонів ця функція наразі не гарантує, що результат є дійсним. Цю ситуацію можна перевірити за допомогою <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.
uk: Приклад: 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.
uk: Приклад: Оскільки точки лише сортуються і нові точки не обчислюються, результат функції ST_RemoveIrrelevantPointsForView() може містити самоперетини.

note: Tag: refpurpose
en: Removes small parts (polygon rings or linestrings) of a geometry.
uk: Видаляє невеликі частини (кільця полігону або лінії) геометрії.

note: Tag: para
en: Returns a <xref linkend="geometry"/> without small parts (exterior or interior polygon rings, or linestrings).
uk: Повертає <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.
uk: Ця функція може бути використана як попередній етап обробки для створення спрощених карт, наприклад, для видалення невеликих островів або отворів.

note: Tag: para
en: It evaluates only geometries of type (MULTI)POLYGON and (MULTI)LINESTRING. Other geometries remain unchanged.
uk: Він оцінює тільки геометрії типу (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>.
uk: Якщо <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>.
uk: Якщо <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.
uk: Обидва параметри <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:
uk: Для типів полігонів оцінка проводиться окремо для кожного кільця, що може призвести до одного з наступних результатів:

note: Tag: para
en: the original geometry,
uk: оригінальна геометрія,

note: Tag: para
en: a POLYGON with all rings with less vertices,
uk: POLYGON з усіма кільцями з меншою кількістю вершин,

note: Tag: para
en: a POLYGON with a reduced number of interior rings (having possibly less vertices),
uk: POLYGON зі зменшеною кількістю внутрішніх кілець (можливо, з меншою кількістю вершин),

note: Tag: para
en: a POLYGON EMPTY, or
uk: POLYGON EMPTY, або

note: Tag: para
en: a MULTIPOLYGON with a reduced number of polygons (having possibly less interior rings or vertices), or
uk: MULTIPOLYGON зі зменшеною кількістю полігонів (можливо, з меншою кількістю внутрішніх кілець або вершин), або

note: Tag: para
en: a MULTIPOLYGON EMPTY.
uk: MULTIPOLYGON EMPTY.

note: Tag: para
en: For linestring types, evaluation is done for each linestring which can lead to one of the following results:
uk: Для типів лінійних рядків оцінка виконується для кожної лінії, що може призвести до одного з таких результатів:

note: Tag: para
en: a LINESTRING with a reduced number of vertices,
uk: LINESTRING зі зменшеною кількістю вершин,

note: Tag: para
en: a LINESTRING EMPTY,
uk: LINESTRING EMPTY,

note: Tag: para
en: a MULTILINESTRING with a reduced number of linestrings (having possibly less vertices), or
uk: MULTILINESTRING зі зменшеною кількістю лінійних ланцюгів (які можуть мати менше вершин), або

note: Tag: para
en: a MULTILINESTRING EMPTY.
uk: MULTILINESTRING EMPTY.

note: Tag: para
en: Example: ST_RemoveSmallParts() applied to a multi-polygon. Blue parts remain.
uk: Приклад: ST_RemoveSmallParts() застосовано до мультиполігону. Сині частини залишаються.

note: Tag: refpurpose
en: Return the geometry with vertex order reversed.
uk: Повернути геометрію з оберненим порядком вершин.

note: Tag: para
en: Can be used on any geometry and reverses the order of the vertices.
uk: Може використовуватися для будь-якої геометрії та змінює порядок вершин.

note: Tag: para
en: Enhanced: 2.4.0 support for curves was introduced.
uk: Покращено: 2.4.0 додано підтримку кривих.

note: Tag: refpurpose
en: Returns a modified geometry/geography having no segment longer than a given distance.
uk: Повертає змінену геометрію/географію, в якій немає сегментів, довжина яких перевищує задану відстань.

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.
uk: Повертає змінену геометрію/географію, в якій немає сегментів довжиною більше <varname>max_segment_length</varname>. Довжина обчислюється у 2D. Сегменти завжди розділяються на підсегменти однакової довжини.

note: Tag: para
en: For geometry, the maximum length is in the units of the spatial reference system.
uk: Для геометрії максимальна довжина вимірюється в одиницях просторової системи відліку.

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.
uk: Для географії максимальна довжина вимірюється в метрах. Відстані обчислюються на сфері. Додані вершини створюються вздовж дуг сферичного великого кола, визначених кінцевими точками відрізків.

note: Tag: para
en: This only shortens long segments. It does not lengthen segments shorter than the maximum length.
uk: Це тільки скорочує довгі сегменти. Сегменти, довжина яких не перевищує максимальну, не подовжуються.

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.
uk: Для вхідних даних, що містять довгі сегменти, вказання відносно короткого <varname>max_segment_length</varname> може призвести до додавання дуже великої кількості вершин. Це може статися ненавмисно, якщо аргумент випадково вказано як кількість сегментів, а не максимальну довжину.

note: Tag: para
en: Enhanced: 3.0.0 Segmentize geometry now produces equal-length subsegments
uk: Покращено: 3.0.0 Сегментація геометрії тепер створює підсегменти однакової довжини

note: Tag: para
en: Enhanced: 2.3.0 Segmentize geography now produces equal-length subsegments
uk: Покращено: 2.3.0 Сегментація географії тепер створює підсегменти однакової довжини

note: Tag: para
en: Enhanced: 2.1.0 support for geography was introduced.
uk: Покращено: 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>
uk: Змінено: 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.
uk: Сегментація лінії. Довгі сегменти розділяються рівномірно, а короткі сегменти не розділяються.

note: Tag: para
en: Segmentizing a polygon:
uk: Сегментація полігону:

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.
uk: Сегментація географічної лінії з використанням максимальної довжини сегмента 2000 кілометрів. Вершини додаються вздовж дуги великого кола, що з'єднує кінцеві точки.

note: Tag: para
en: A geographic line segmentized along a great circle arc
uk: Географічна лінія, сегментована вздовж дуги великого кола

note: Tag: refpurpose
en: Replace point of a linestring with a given point.
uk: Замінити точку лінійного об'єкта на задану точку.

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.
uk: Замінити точку N лінійного елемента на задану точку. Індекс починається з 0. Негативні індекси рахуються назад, так що -1 є останньою точкою. Це особливо корисно в тригерах, коли потрібно зберегти зв'язки між суглобами при переміщенні однієї вершини.

note: Tag: para
en: Updated 2.3.0 : negative indexing
uk: Оновлено 2.3.0: негативна індексація

note: Tag: refpurpose
en: Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
uk: Змінює координати довготи геометрії в діапазоні від -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.
uk: Зчитує кожну точку/вершину в геометрії та зміщує її координату довготи з -180..0 на 180..360 і навпаки, якщо вона знаходиться в цих діапазонах. Ця функція є симетричною, тому результатом є представлення даних -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)
uk: Це корисно тільки для даних з координатами в довготі/широті; наприклад, SRID 4326 (географічна система WGS 84).

note: Tag: para
en: Pre-1.3.4 bug prevented this from working for MULTIPOINT. 1.3.4+ works with MULTIPOINT as well.
uk: Помилка версії до 1.3.4 заважала цій функції працювати з MULTIPOINT. Версія 1.3.4+ також працює з MULTIPOINT.

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
uk: Покращено: 2.0.0 додано підтримку багатогранних поверхонь та TIN.

note: Tag: para
en: NOTE: this function was renamed from "ST_Shift_Longitude" in 2.2.0
uk: ПРИМІТКА: ця функція була перейменована з "ST_Shift_Longitude" у версії 2.2.0

note: Tag: refpurpose
en: Wrap a geometry around an X value.
uk: Оберніть геометрію навколо значення 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.
uk: Ця функція розділяє вхідні геометрії, а потім переміщує кожен отриманий компонент, що потрапляє праворуч (для від'ємного значення “move”) або ліворуч (для додатного значення “move”) від заданої лінії “wrap” у напрямку, визначеному параметром “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.
uk: Це корисно для "перецентрування" вхідних даних довготи та широти, щоб об'єкти, що представляють інтерес, не з'являлися з одного боку на інший.

note: Tag: para
en: Availability: 2.3.0 requires GEOS
uk: Доступність: 2.3.0 вимагає GEOS

note: Tag: refpurpose
en: Snap all points of the input geometry to a regular grid.
uk: Прив'яжіть всі точки вхідної геометрії до регулярної сітки.

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.
uk: Варіант 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.
uk: Варіант 4: Введено в версії 1.1.0 — прив'язує всі точки вхідної геометрії до сітки, визначеної її початком (другий аргумент, повинен бути точкою) і розмірами комірок. Вкажіть 0 як розмір для будь-якого виміру, який не потрібно прив'язувати до сітки.

note: Tag: para
en: The returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>).
uk: Повернена геометрія може втратити свою простоту (див. <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.
uk: До версії 1.1.0 ця функція завжди повертала 2D-геометрію. Починаючи з версії 1.1.0, повернена геометрія матиме ту саму розмірність, що й вхідна, а значення вищих розмірностей залишатимуться незмінними. Використовуйте версію, що приймає другий аргумент геометрії, щоб визначити всі розмірності сітки.

note: Tag: para
en: Availability: 1.0.0RC1
uk: Доступність: 1.0.0RC1

note: Tag: para
en: Availability: 1.1.0 - Z and M support
uk: Доступність: 1.1.0 - підтримка Z і M

note: Tag: refpurpose
en: Snap segments and vertices of input geometry to vertices of a reference geometry.
uk: Прив'язати сегменти та вершини вхідної геометрії до вершин еталонної геометрії.

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.
uk: Прив'язує вершини та сегменти геометрії до вершин іншої геометрії. Для контролю місця прив'язки використовується допуск відстані прив'язки. Результатом є геометрія з прив'язаними вершинами. Якщо прив'язка не відбувається, геометрія залишається без змін.

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).
uk: З'єднання однієї геометрії з іншою може підвищити надійність операцій накладання, усуваючи майже збіжні краї (які спричиняють проблеми під час обчислення вузлів і перетинів).

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.
uk: Занадто часте прив'язування може призвести до створення некоректної топології, тому кількість і розташування прив'язаних вершин визначається за допомогою евристичних методів, які визначають, коли прив'язування є безпечним. Однак це може призвести до пропуску деяких потенційних прив'язок.

note: Tag: para
en: The returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>) and validity (see <xref linkend="ST_IsValid"/>).
uk: Повернена геометрія може втратити свою простоту (див. <xref linkend="ST_IsSimple"/>) та валідність (див. <xref linkend="ST_IsValid"/>).

note: Tag: para
en: A multipolygon shown with a linestring (before any snapping)
uk: Мультиполігон, показаний лінією (до будь-якого прив'язування)

note: Tag: para
en: A multipolygon snapped to linestring to tolerance: 1.01 of distance. The new multipolygon is shown with reference linestring
uk: Мультиполігон, прив'язаний до лінії з точністю до 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
uk: Мультиполігон, прив'язаний до лінії з допуском: 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
uk: Лінія прив'язалася до вихідного мультиполігону з допуском 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
uk: Лінія прив'язалася до вихідного мультиполігону з допуском 1,25 відстані. Нова лінія відображається з посиланням на мультиполігон

note: Tag: refpurpose
en: Returns a version of the given geometry with given ordinate values swapped.
uk: Повертає версію заданої геометрії із заміненими значеннями ординат.

note: Tag: para
en: Returns a version of the given geometry with given ordinates swapped.
uk: Повертає версію заданої геометрії із заміненими заданими координатами.

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.
uk: Параметр <varname>ords</varname> — це 2-символьний рядок, що позначає координати, які потрібно поміняти місцями. Допустимі імена: x, y, z та m.

note: Tag: title
en: Exceptional Functions
uk: Особливі функції

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.
uk: Ці функції використовуються рідко і застосовуються лише у випадку пошкодження даних. Вони призначені для усунення несправностей та виправлення помилок, які за звичайних обставин не повинні виникати.

note: Tag: refpurpose
en: Add bounding box to the geometry.
uk: Додати обмежувальну рамку до геометрії.

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.
uk: Додати обмежувальну рамку до геометрії. Це пришвидшить запити на основі обмежувальної рамки, але збільшить розмір геометрії.

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.
uk: Обмежувальні рамки автоматично додаються до геометрій, тому, як правило, це не потрібно, якщо тільки створена обмежувальна рамка якимось чином не пошкодилася або у вас стара версія, в якій відсутні обмежувальні рамки. Тоді вам потрібно видалити стару і додати нову.

note: Tag: refpurpose
en: Drop the bounding box cache from the geometry.
uk: Видалити кеш обмежувальної рамки з геометрії.

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.
uk: Видалити кеш обмежувальної рамки з геометрії. Це зменшує розмір геометрії, але уповільнює запити на основі обмежувальної рамки. Також використовується для видалення пошкодженої обмежувальної рамки. Ознакою пошкодження кешованої обмежувальної рамки є те, що 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.
uk: Обмежувальні рамки автоматично додаються до геометрій і покращують швидкість запитів, тому, як правило, це не потрібно, якщо тільки створена обмежувальна рамка якимось чином не пошкодилася або у вас стара версія, в якій відсутні обмежувальні рамки. У такому випадку потрібно видалити старі та додати заново. Таке пошкодження спостерігалося в серіях 8.3-8.3.6, де кешовані bboxes не завжди перераховувалися при зміні геометрії, і оновлення до нової версії без перезавантаження дампа не виправляє вже пошкоджені рамки. Тому можна вручну виправити за допомогою наведеного нижче коду та додати bbox заново або виконати перезавантаження дампа.

note: Tag: refpurpose
en: Returns TRUE if the bbox of this geometry is cached, FALSE otherwise.
uk: Повертає TRUE, якщо bbox цієї геометрії кешована, і 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.
uk: Повертає TRUE, якщо bbox цієї геометрії кешована, і FALSE в іншому випадку. Використовуйте <xref linkend="PostGIS_AddBBox"/>та <xref linkend="PostGIS_DropBBox"/>для керування кешуванням.

note: Tag: title
en: Grand Unified Custom Variables (GUCs)
uk: Великі уніфіковані змінні (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.
uk: У цьому розділі перелічено власні великі уніфіковані змінні PostGIS (GUC). Їх можна налаштувати глобально, для бази даних, для сеансу або для транзакції. Найкраще налаштовувати на глобальному рівні або на рівні бази даних.

note: Tag: para
en: For more examples of usage refer to <link xlink:href="https://www.postgresql.org/docs/current/sql-set.html">SQL SET</link> and <link xlink:href="https://www.postgresql.org/docs/current/sql-altersystem.html">SQL ALTER SYSTEM</link>
uk: Більше прикладів використання див. <link xlink:href="https://www.postgresql.org/docs/current/sql-set.html">SQL SET</link> та <link xlink:href="https://www.postgresql.org/docs/current/sql-altersystem.html">SQL ALTER SYSTEM</link>

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.
uk: Параметр конфігурації для призначення значення параметра GDAL_DATA GDAL. Якщо не встановлено, використовується змінна 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.
uk: Змінна PostgreSQL GUC для встановлення значення опції GDAL_DATA GDAL. Значення <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.
uk: Ця опція конфігурації найбільш корисна для платформ Windows, де шлях до файлів даних GDAL не є жорстко заданим. Цю опцію також слід встановити, якщо файли даних 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.
uk: Цей параметр можна встановити у файлі конфігурації PostgreSQL postgresql.conf. Його також можна встановити для окремого з'єднання або транзакції.

note: Tag: para
en: Additional information about GDAL_DATA is available at GDAL's <link xlink:href="https://gdal.org/user/configoptions.html">Configuration Options</link>.
uk: Додаткова інформація про GDAL_DATA доступна в розділі "Параметри конфігурації" на сайті GDAL <link xlink:href="https://gdal.org/user/configoptions.html">Опція конфігурації</link>.

note: Tag: para
en: Set and reset <varname>postgis.gdal_datapath</varname>
uk: Встановити та скинути <varname>postgis.gdal_datapath</varname>

note: Tag: para
en: Setting on windows for a particular database
uk: Налаштування 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.
uk: Параметр конфігурації для встановлення увімкнених драйверів GDAL у середовищі PostGIS. Впливає на змінну конфігурації 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.
uk: Параметр конфігурації для встановлення увімкнених драйверів GDAL у середовищі PostGIS. Впливає на змінну конфігурації 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.
uk: Початкове значення <varname>postgis.gdal_enabled_drivers</varname> також можна встановити, передавши змінну середовища <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> зі списком увімкнених драйверів процесу, що запускає PostgreSQL.

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.
uk: Увімкнені драйвери 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.
uk: Для <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>.
uk: <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.
uk: <varname>ENABLE_ALL</varname> вмикає всі драйвери GDAL.

note: Tag: para
en: <varname>VSICURL</varname> enables GDAL's <varname>/vsicurl/</varname> virtual file system.
uk: <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.
uk: Коли <varname>postgis.gdal_enabled_drivers</varname> встановлено на DISABLE_ALL, спроби використання растрів out-db, 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.
uk: У стандартній установці PostGIS <varname>postgis.gdal_enabled_drivers</varname> встановлено на DISABLE_ALL.

note: Tag: para
en: Additional information about GDAL_SKIP is available at GDAL's <link xlink:href="https://gdal.org/user/configoptions.html">Configuration Options</link>.
uk: Додаткова інформація про GDAL_SKIP доступна в розділі "Параметри конфігурації" на сайті GDAL <link xlink:href="https://gdal.org/user/configoptions.html">Опція конфігурації</link>.

note: Tag: para
en: To set and reset <varname>postgis.gdal_enabled_drivers</varname> for current session
uk: Встановити та скинути <varname>postgis.gdal_enabled_drivers</varname> для поточного сеансу

note: Tag: para
en: Set for all new connections to a specific database to specific drivers
uk: Встановити для всіх нових підключень до певної бази даних конкретні драйвери

note: Tag: para
en: Setting for whole database cluster to enable all drivers. Requires super user access. Also note that database, session, and user settings override this.
uk: Налаштування для всього кластера бази даних, щоб увімкнути всі драйвери. Потрібен доступ суперкористувача. Також зверніть увагу, що налаштування бази даних, сеансу та користувача мають пріоритет над цими налаштуваннями.

note: Tag: refpurpose
en: A boolean configuration option to enable access to out-db raster bands.
uk: Булева опція конфігурації для увімкнення доступу до растрових смуг out-db.

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.
uk: Булева опція конфігурації для увімкнення доступу до растрових смуг out-db. Цю опцію можна встановити у файлі конфігурації 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.
uk: Початкове значення <varname>postgis.enable_outdb_rasters</varname> також можна встановити, передавши змінну середовища <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> з значенням, відмінним від нуля, процесу, що запускає 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.
uk: Навіть якщо <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.
uk: У стандартній установці PostGIS <varname>postgis.enable_outdb_rasters</varname> встановлено на False.

note: Tag: para
en: Set and reset <varname>postgis.enable_outdb_rasters</varname> for current session
uk: Встановити та скинути <varname>postgis.enable_outdb_rasters</varname> для поточної сесії

note: Tag: para
en: Set for all new connections to a specific database
uk: Встановити для всіх нових підключень до певної бази даних

note: Tag: para
en: Setting for whole database cluster. Requires super user access. Also note that database, session, and user settings override this.
uk: Налаштування для всього кластера бази даних. Потрібен доступ суперкористувача. Також зверніть увагу, що налаштування бази даних, сеансу та користувача мають пріоритет над цими налаштуваннями.

note: Tag: refpurpose
en: A string configuration to set options used when working with an out-db raster.
uk: Конфігурація рядка для встановлення параметрів, що використовуються під час роботи з растровим файлом out-db.

note: Tag: para
en: A string configuration to set options used when working with an out-db raster. <link xlink:href="https://gdal.org/user/configoptions.html">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.
uk: Конфігурація рядка для встановлення опцій, що використовуються під час роботи з растровим файлом out-db. <link xlink:href="https://gdal.org/user/configoptions.html">Опції конфігурації</link> контролюють такі параметри, як обсяг простору, що GDAL виділяє для локального кешу даних, чи читати огляди та які ключі доступу використовувати для віддалених джерел даних out-db.

note: Tag: para
en: Set <varname>postgis.gdal_vsi_options</varname> for current session:
uk: Встановити <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:
uk: Встановіть <varname>postgis.gdal_vsi_options</varname> тільки для <emphasis>поточної транзакції</emphasis> за допомогою ключового слова <varname>LOCAL</varname>:

note: Tag: refpurpose
en: A boolean configuration to turn logging of GDAL debug messages on and off.
uk: Булева конфігурація для ввімкнення та вимкнення реєстрації повідомлень про налагодження GDAL.

note: Tag: para
en: By default, GDAL logging is printed to stderr, and lower level debug messages are not printed at all. Turning this GUC to true will cause GDAL logging to be sent into the PostgreSQL logging stream, so you can see more or less of it by altering the <code>client_min_message</code> PostgreSQL GUC.
uk: За замовчуванням, журнали GDAL друкуються на stderr, а повідомлення нижчого рівня не друкуються взагалі. Встановлення цього GUC на true призведе до надсилання журналів GDAL до потоку журналів PostgreSQL, тож ви зможете бачити більше або менше з них, змінюючи <code>client_min_message</code> PostgreSQL GUC.

note: Tag: title
en: Geometry Input
uk: Введення геометрії

note: Tag: para
en: These functions create geometry objects from various textual or binary formats.
uk: Ці функції створюють геометричні об'єкти з різних текстових або бінарних форматів.

note: Tag: refpurpose
en: <refpurpose>Construct a Polygon given an arbitrary collection of closed linestrings as a MultiLineString Well-Known text representation.</refpurpose>
uk: <refpurpose>Побудувати полігон, заданий довільною сукупністю замкнутих лінійних відрізків у вигляді добре відомого текстового представлення MultiLineString.</refpurpose>

note: Tag: para
en: <para>Construct a Polygon given an arbitrary collection of closed linestrings as a MultiLineString Well-Known text representation.</para>
uk: <para>Побудувати полігон, заданий довільною сукупністю замкнутих лінійних відрізків у вигляді добре відомого текстового представлення MultiLineString.</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.
uk: Видає помилку, якщо WKT не є MULTILINESTRING. Видає помилку, якщо вихідні дані є MULTIPOLYGON; у цьому випадку використовуйте ST_BdMPolyFromText або дивіться ST_BuildArea() для підходу, специфічного для postgis.

note: Tag: refpurpose
en: Construct a MultiPolygon given an arbitrary collection of closed linestrings as a MultiLineString text representation Well-Known text representation.
uk: Побудувати мультиполігон на основі довільної сукупності замкнутих лінійних відрізків у вигляді текстового представлення MultiLineString. Загальновідоме текстове представлення.

note: Tag: para
en: Construct a Polygon given an arbitrary collection of closed linestrings, polygons, MultiLineStrings as Well-Known text representation.
uk: Побудувати полігон, заданий довільною сукупністю замкнутих ліній, полігонів, багатолінійних ліній у вигляді добре відомого текстового представлення.

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.
uk: Видає помилку, якщо WKT не є MULTILINESTRING. Примусово виводить MULTIPOLYGON, навіть якщо результат насправді складається лише з одного POLYGON; використовуйте <link linkend="ST_BdPolyFromText">ST_BdPolyFromText</link>, якщо ви впевнені, що в результаті операції буде отримано один POLYGON, або дивіться <link linkend="ST_BuildArea">ST_BuildArea()</link> для підходу, специфічного для postgis.

note: Tag: refpurpose
en: Return a specified geography value from Well-Known Text representation or extended (WKT).
uk: Повернути вказане географічне значення з представлення 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.
uk: Повертає географічний об'єкт із відомого тексту або розширеного відомого представлення. Якщо не вказано, використовується SRID 4326. Це псевдонім для ST_GeographyFromText. Точки завжди виражаються у форматі довготи та широти.

note: Tag: para
en: Returns a geography object from the well-known text representation. SRID 4326 is assumed if unspecified.
uk: Повертає географічний об'єкт із загальновідомого текстового представлення. Якщо не вказано, використовується 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.
uk: Створює колекцію Geometry з колекції 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.
uk: Створює колекцію Geometry з представлення Well-Known-Text (WKT) із заданим SRID. Якщо SRID не вказано, за замовчуванням використовується 0.

note: Tag: para
en: OGC SPEC 3.2.6.2 - option SRID is from the conformance suite
uk: OGC SPEC 3.2.6.2 — опція SRID взята з набору вимог відповідності

note: Tag: para
en: Returns null if the WKT is not a GEOMETRYCOLLECTION
uk: Повертає null, якщо WKT не є GEOMETRYCOLLECTION

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.
uk: Якщо ви абсолютно впевнені, що всі ваші геометрії WKT є колекціями, не використовуйте цю функцію. Вона працює повільніше, ніж ST_GeomFromText, оскільки додає додатковий крок перевірки.

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Extended Well-Known Text representation (EWKT).
uk: Повернути вказане значення ST_Geometry з розширеного представлення добре відомого тексту (EWKT).

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known text (EWKT) representation.
uk: Створює об'єкт PostGIS ST_Geometry з представлення OGC Extended Well-Known text (EWKT).

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
uk: Формат EWKT не є стандартом OGC, а специфічним форматом PostGIS, що включає ідентифікатор просторової системи координат (SRID).

note: Tag: refpurpose
en: Takes MARC21/XML geographic data as input and returns a PostGIS geometry object.
uk: Приймає географічні дані 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).
uk: Ця функція створює геометрію PostGIS з запису MARC21/XML, який може містити <varname>POINT</varname> або <varname>POLYGON</varname>. У разі наявності декількох географічних даних в одному записі MARC21/XML, буде повернуто <varname>MULTIPOINT</varname> або <varname>MULTIPOLYGON</varname>. Якщо запис містить змішані типи геометрії, буде повернуто <varname>GEOMETRYCOLLECTION</varname>. Повертає NULL, якщо запис MARC21/XML не містить географічних даних (поле даних: 034).

note: Tag: para
en: LOC MARC21/XML versions supported:
uk: Підтримувані версії LOC MARC21/XML:

note: Tag: para
en: Availability: 3.3.0, requires libxml2 2.6+
uk: Доступність: 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>.
uk: Кодовані картографічні математичні дані MARC21/XML наразі не надають жодних засобів для опису просторової системи координат закодованих координат, тому ця функція завжди повертатиме геометрію з <varname>SRID 0</varname>.

note: Tag: para
en: Returned <varname>POLYGON</varname> geometries will always be clockwise oriented.
uk: Повернуті геометрії <varname>POLYGON</varname> завжди будуть орієнтовані за годинниковою стрілкою.

note: Tag: para
en: Converting MARC21/XML geographic data containing a single <varname>POINT</varname> encoded as <varname>hddd.dddddd</varname>
uk: Перетворення географічних даних MARC21/XML, що містять один <varname>POINT</varname>, закодований як <varname>hddd.dddddd</varname>

note: Tag: para
en: Converting MARC21/XML geographic data containing a single <varname>POLYGON</varname> encoded as <varname>hdddmmss</varname>
uk: Перетворення географічних даних MARC21/XML, що містять один <varname>POLYGON</varname>, закодований як <varname>hdddmmss</varname>

note: Tag: para
en: Converting MARC21/XML geographic data containing a <varname>POLYGON</varname> and a <varname>POINT</varname>:
uk: Перетворення географічних даних MARC21/XML, що містять <varname>POLYGON</varname> та <varname>POINT</varname>:

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Text representation (WKT). This is an alias name for ST_GeomFromText
uk: Повертає вказане значення ST_Geometry з представлення Well-Known Text (WKT). Це псевдонім для ST_GeomFromText.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.40
uk: &sqlmm_compliant; SQL-MM 3: 5.1.4

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Text representation (WKT).
uk: Повертає вказане значення ST_Geometry з представлення Well-Known Text (WKT).

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Well-Known text representation.
uk: Створює об'єкт PostGIS ST_Geometry на основі текстового представлення OGC Well-Known.

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.
uk: Існує два варіанти функції ST_GeomFromText. Перший не приймає SRID і повертає геометрію без визначеної системи просторових координат (SRID=0). Другий приймає SRID як другий аргумент і повертає геометрію, яка включає цей SRID як частину своїх метаданих.

note: Tag: para
en: &sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite.
uk: &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.
uk: Хоча <xref linkend="ST_MakePoint"/> не відповідає стандарту OGC, він працює швидше, ніж ST_GeomFromText і ST_PointFromText. Він також простіший у використанні для числових значень координат. <xref linkend="ST_Point"/> — це інший варіант, схожий за швидкістю на <xref linkend="ST_MakePoint"/> і сумісний з OGC, але підтримує тільки 2D-точки.

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')
uk: Змінено: 2.0.0 У попередніх версіях PostGIS ST_GeomFromText(“GEOMETRYCOLLECTION(EMPTY)”) було дозволено. Тепер це є некоректним у PostGIS 2.0.0 для кращої відповідності стандартам SQL/MM. Тепер це слід писати як 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.
uk: Створює геометрію з представлення 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.
uk: Створює геометрію з WKT із заданим SRID. Якщо SRID не вказано, за замовчуванням використовується 0. Якщо переданий WKT не є LINESTRING, повертається null.

note: Tag: para
en: OGC SPEC 3.2.6.2 - option SRID is from the conformance suite.
uk: 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.
uk: Якщо ви знаєте, що всі ваші геометрії є LINESTRINGS, ефективніше просто використовувати ST_GeomFromText. Це просто викликає ST_GeomFromText і додає додаткову перевірку, що він повертає лінію.

note: Tag: refpurpose
en: Return a specified ST_MultiLineString value from WKT representation.
uk: Повернути вказане значення ST_MultiLineString з представлення WKT.

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.
uk: Створює геометрію з добре відомого тексту (WKT) із заданим SRID. Якщо SRID не задано, за замовчуванням використовується 0.

note: Tag: para
en: Returns null if the WKT is not a MULTILINESTRING
uk: Повертає null, якщо WKT не є MULTILINESTRING

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.
uk: Якщо ви абсолютно впевнені, що всі ваші геометрії 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>
uk: <refpurpose>Створює геометрію з 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>
uk: <para>Створює геометрію з WKT із заданим SRID. Якщо SRID не вказано, за замовчуванням використовується значення 0.</para>

note: Tag: para
en: Returns null if the WKT is not a MULTIPOINT
uk: Повертає null, якщо WKT не є MULTIPOINT

note: Tag: refpurpose
en: Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0.
uk: Створює геометрію MultiPolygon з 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.
uk: Створює багатокутник з WKT із заданим SRID. Якщо SRID не задано, за замовчуванням використовується 0.

note: Tag: para
en: Throws an error if the WKT is not a MULTIPOLYGON
uk: Видає помилку, якщо 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.
uk: Якщо ви абсолютно впевнені, що всі ваші геометрії 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.
uk: Створює точку Геометрія з WKT із заданим SRID. Якщо SRID не вказано, за замовчуванням використовується невідомий.

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.
uk: Створює об'єкт точки PostGIS ST_Geometry з текстового представлення OGC Well-Known. Якщо 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.
uk: Існує 2 варіанти функції ST_PointFromText, перший не приймає SRID і повертає геометрію без визначеної системи просторових координат. Другий приймає ідентифікатор просторової координатної системи як другий аргумент і повертає ST_Geometry, що включає цей srid як частину своїх метаданих. 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"/>.
uk: Якщо ви абсолютно впевнені, що всі ваші геометрії 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.
uk: Створює геометрію з WKT із заданим SRID. Якщо SRID не задано, за замовчуванням використовується 0. Повертає null, якщо WKT не є полігоном.

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.
uk: Якщо ви абсолютно впевнені, що всі ваші геометрії WKT є полігонами, не використовуйте цю функцію. Вона працює повільніше, ніж ST_GeomFromText, оскільки додає додатковий крок перевірки.

note: Tag: title
en: Well-Known Binary (WKB)
uk: Добре відомий бінарний файл (WKB)

note: Tag: refpurpose
en: Creates a geography instance from a Well-Known Binary geometry representation (WKB) or extended Well Known Binary (EWKB).
uk: Створює географічний екземпляр на основі добре відомого двійкового геометричного представлення (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.
uk: Функція <varname>ST_GeogFromWKB</varname> бере добре відоме двійкове представлення (WKB) геометрії або PostGIS Extended WKB і створює екземпляр відповідного типу географії. Ця функція виконує роль Geometry Factory в SQL.

note: Tag: para
en: If SRID is not specified, it defaults to 4326 (WGS 84 long lat).
uk: Якщо SRID не вказано, за замовчуванням використовується значення 4326 (WGS 84 long lat).

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Extended Well-Known Binary representation (EWKB).
uk: Повернути вказане значення ST_Geometry з розширеного добре відомого двійкового представлення (EWKB).

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known binary (EWKT) representation.
uk: Створює об'єкт PostGIS ST_Geometry з представлення OGC Extended Well-Known binary (EWKT).

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
uk: Формат 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).
uk: лінія бінарне представлення LINESTRING(-71.160281 42.258729,-71.160837 42.259113,-71.161144 42.25932) in NAD 83 long lat (4269).

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.
uk: ПРИМІТКА: Незважаючи на те, що масиви байтів розділяються символом \ і можуть містити символ “, нам потрібно екранувати обидва символи за допомогою \ і ”', якщо стандарт 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
uk: У PostgreSQL 9.1+ - standard_conforming_strings за замовчуванням встановлено на on, тоді як у попередніх версіях було встановлено на off. Ви можете змінити значення за замовчуванням за потреби для окремого запиту або на рівні бази даних чи сервера. Нижче наведено, як це зробити, якщо standard_conforming_strings = on. У цьому випадку ми екрануємо “ за допомогою стандартного ansi ”, але коси риски не екрануються

note: Tag: refpurpose
en: Creates a geometry instance from a Well-Known Binary geometry representation (WKB) and optional SRID.
uk: Створює екземпляр геометрії з добре відомого двійкового представлення геометрії (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.
uk: Функція <varname>ST_GeomFromWKB</varname> приймає добре відоме двійкове представлення геометрії та ідентифікатор просторової системи відліку (<varname>SRID</varname>) і створює екземпляр відповідного типу геометрії. Ця функція виконує роль Geometry Factory в SQL. Це альтернативна назва для ST_WKBToSQL.

note: Tag: para
en: If SRID is not specified, it defaults to 0 (Unknown).
uk: Якщо SRID не вказано, за замовчуванням використовується значення 0 (Невідомо).

note: Tag: para
en: &sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite
uk: &sfs_compliant; s3.2.7.2 - необов'язковий SRID з набору вимог відповідності

note: Tag: refpurpose
en: Makes a <varname>LINESTRING</varname> from WKB with the given SRID
uk: Створює <varname>LINESTRING</varname> з WKB із заданим SRID

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.
uk: Функція <varname>ST_LineFromWKB</varname> приймає добре відоме двійкове представлення геометрії та ідентифікатор просторової системи відліку (<varname>SRID</varname>) і створює екземпляр відповідного типу геометрії — у цьому випадку геометрії <varname>LINESTRING</varname>. Ця функція виконує роль Geometry Factory в 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>.
uk: Якщо 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.
uk: Якщо ви знаєте, що всі ваші геометрії є <varname>LINESTRING</varname>s, ефективніше просто використовувати <xref linkend="ST_GeomFromWKB"/>. Ця функція просто викликає <xref linkend="ST_GeomFromWKB"/> і додає додаткову перевірку, що вона повертає лінію.

note: Tag: refpurpose
en: Makes a geometry from WKB with the given SRID.
uk: Створює геометрію з 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.
uk: Функція <varname>ST_LinestringFromWKB</varname> приймає добре відоме двійкове представлення геометрії та ідентифікатор просторової системи координат (<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"/>.
uk: Якщо SRID не вказано, за замовчуванням використовується 0. <varname>NULL</varname> повертається, якщо вхідний <varname>bytea</varname> не представляє геометрію <varname>LINESTRING</varname>. Це псевдонім для <xref linkend="ST_LineFromWKB"/>.

note: Tag: para
en: OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite.
uk: 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>.
uk: Якщо ви знаєте, що всі ваші геометрії є <varname>LINESTRING</varname>s, ефективніше просто використовувати <xref linkend="ST_GeomFromWKB"/>. Ця функція просто викликає <xref linkend="ST_GeomFromWKB"/> і додає додаткову перевірку, що вона повертає <varname>LINESTRING</varname>.

note: Tag: refpurpose
en: Makes a geometry from WKB with the given SRID
uk: Створює геометрію з 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.
uk: Функція <varname>ST_PointFromWKB</varname> приймає добре відоме двійкове представлення геометрії та ідентифікатор просторової системи відліку (<varname>SRID</varname>) і створює екземпляр відповідного типу геометрії — у цьому випадку геометрії <varname>POINT</varname>. Ця функція виконує роль Geometry Factory в 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.
uk: Якщо 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
uk: Повертає вказане значення ST_Geometry з добре відомого двійкового представлення (WKB). Це псевдонім для ST_GeomFromWKB, який не приймає srid.

note: Tag: title
en: Other Formats
uk: Інші формати

note: Tag: refpurpose
en: <refpurpose>Return a BOX2D from a GeoHash string.</refpurpose>
uk: <refpurpose>Повернути BOX2D із рядка GeoHash.</refpurpose>

note: Tag: para
en: <para>Return a BOX2D from a GeoHash string.</para>
uk: <para>Повернути BOX2D із рядка GeoHash.</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.
uk: Якщо не вказано <varname>precision</varname>, ST_Box2dFromGeoHash повертає BOX2D на основі повної точності вхідного рядка GeoHash.

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.
uk: Якщо вказано <varname>precision</varname>, ST_Box2dFromGeoHash використає стільки символів з GeoHash, щоб створити BOX2D. Менші значення точності дають більші BOX2D, а більші значення збільшують точність.

note: Tag: refpurpose
en: Return a geometry from a GeoHash string.
uk: Повернути геометрію з рядка GeoHash.

note: Tag: para
en: Return a geometry from a GeoHash string. The geometry will be a polygon representing the GeoHash bounds.
uk: Повернути геометрію з рядка 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.
uk: Якщо не вказано <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.
uk: Якщо вказано <varname>precision</varname>, ST_GeomFromGeoHash використає стільки символів з GeoHash, щоб створити полігон.

note: Tag: refpurpose
en: Takes as input GML representation of geometry and outputs a PostGIS geometry object
uk: Приймає в якості вхідних даних GML-представлення геометрії та видає об'єкт геометрії PostGIS

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC GML representation.
uk: Створює об'єкт PostGIS ST_Geometry з представлення OGC GML.

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.
uk: 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>:
uk: Підтримувані версії 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+
uk: Доступність: 1.5, вимагає libxml2 1.6+

note: Tag: para
en: Enhanced: 2.0.0 default srid optional parameter added.
uk: Покращено: 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.
uk: GML дозволяє змішані розміри (наприклад, 2D і 3D в одній MultiGeometry). Оскільки геометрії PostGIS цього не дозволяють, ST_GeomFromGML перетворює всю геометрію в 2D, якщо знаходить відсутній розмір Z.

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.
uk: GML підтримує змішані SRS всередині одного MultiGeometry. Оскільки геометрії 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.
uk: Функція ST_GeomFromGML не є педантичною щодо явного простору імен GML. Ви можете не згадувати його явно для загального використання. Але він необхідний, якщо ви хочете використовувати функцію XLink всередині GML.

note: Tag: para
en: ST_GeomFromGML function not support SQL/MM curves geometries.
uk: Функція ST_GeomFromGML не підтримує геометрії кривих SQL/MM.

note: Tag: title
en: Examples - A single geometry with srsName
uk: Приклади - Одинарна геометрія з srsName

note: Tag: title
en: Examples - XLink usage
uk: Приклади - Використання XLink

note: Tag: title
en: Examples - Polyhedral Surface
uk: Приклади - Поліедральна поверхня

note: Tag: refpurpose
en: Takes as input a geojson representation of a geometry and outputs a PostGIS geometry object
uk: Приймає в якості вхідних даних геометричне представлення у форматі geojson і видає геометричний об'єкт PostGIS

note: Tag: para
en: Constructs a PostGIS geometry object from the GeoJSON representation.
uk: Створює об'єкт геометрії PostGIS з представлення GeoJSON.

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.
uk: ST_GeomFromGeoJSON працює тільки для фрагментів JSON Geometry. При спробі використання на всьому документі JSON видається помилка.

note: Tag: para
en: Enhanced: 3.0.0 parsed geometry defaults to SRID=4326 if not specified otherwise.
uk: Покращено: 3.0.0, якщо не вказано інше, геометрія за замовчуванням аналізується як SRID=4326.

note: Tag: para
en: Enhanced: 2.5.0 can now accept json and jsonb as inputs.
uk: Покращено: версія 2.5.0 тепер підтримує json та jsonb як вхідні дані.

note: Tag: para
en: Availability: 2.0.0 requires - JSON-C &gt;= 0.9
uk: Доступність: 2.0.0 вимагає - JSON-C &gt;= 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.
uk: Якщо JSON-C не ввімкнено, замість виводу ви отримаєте повідомлення про помилку. Щоб увімкнути JSON-C, запустіть configure --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
uk: Приймає в якості вхідних даних KML-представлення геометрії та видає об'єкт геометрії PostGIS

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC KML representation.
uk: Створює об'єкт PostGIS ST_Geometry з представлення OGC KML.

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.
uk: 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>:
uk: Підтримувані версії OGC KML: <itemizedlist> <listitem> <para>Простір імен KML 2.2.0</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+
uk: Доступність: 1.5, вимагає libxml2 2.6+

note: Tag: para
en: ST_GeomFromKML function not support SQL/MM curves geometries.
uk: Функція 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.
uk: Створює екземпляр геометрії з представлення геометрії 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.
uk: Функція <varname>ST_GeomFromTWKB</varname> приймає геометричне представлення TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>") (WKB) і створює екземпляр відповідного типу геометрії.

note: Tag: refpurpose
en: Return a specified ST_Geometry value from GML representation. This is an alias name for ST_GeomFromGML
uk: Повертає вказане значення ST_Geometry з представлення GML. Це псевдонім для ST_GeomFromGML.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support).
uk: &sqlmm_compliant; SQL-MM 3: 5.1.50 (крім підтримки кривих).

note: Tag: refpurpose
en: Creates a LineString from an Encoded Polyline.
uk: Створює LineString з закодованої полілінії.

note: Tag: para
en: Creates a LineString from an Encoded Polyline string.
uk: Створює об'єкт LineString із кодованої полілінії.

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.
uk: Опціональний параметр <varname>precision</varname> визначає, скільки десяткових знаків буде збережено в кодованій полілінії. Значення повинно бути однаковим при кодуванні та декодуванні, інакше координати будуть неправильними.

note: Tag: para
en: See http://developers.google.com/maps/documentation/utilities/polylinealgorithm
uk: Див. http://developers.google.com/maps/documentation/utilities/polylinealgorithm

note: Tag: refpurpose
en: Return a point from a GeoHash string.
uk: Повернути точку з рядка GeoHash.

note: Tag: para
en: Return a point from a GeoHash string. The point represents the center point of the GeoHash.
uk: Повернути точку з рядка 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.
uk: Якщо не вказано <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.
uk: Якщо вказано <varname>precision</varname>, ST_PointFromGeoHash використає стільки символів з GeoHash, скільки потрібно для створення точки.

note: Tag: refpurpose
en: Creates a table based on the structure of FlatGeobuf data.
uk: Створює таблицю на основі структури даних 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>).
uk: Створює таблицю на основі структури даних FlatGeobuf. (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>).

note: Tag: para
en: <varname>schema</varname> Schema name.
uk: <varname>schema</varname> Ім'я схеми.

note: Tag: para
en: <varname>table</varname> Table name.
uk: <varname>table</varname> Ім'я таблиці.

note: Tag: para
en: <varname>data</varname> Input FlatGeobuf data.
uk: <varname>data</varname> Введіть дані FlatGeobuf.

note: Tag: refpurpose
en: Reads FlatGeobuf data.
uk: Зчитує дані FlatGeobuf.

note: Tag: para
en: Reads FlatGeobuf data (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>). NOTE: PostgreSQL bytea cannot exceed 1GB.
uk: Читає дані FlatGeobuf (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>). ПРИМІТКА: PostgreSQL bytea не може перевищувати 1 ГБ.

note: Tag: para
en: <varname>tabletype</varname> reference to a table type.
uk: <varname>tabletype</varname> посилання на тип таблиці.

note: Tag: para
en: <varname>data</varname> input FlatGeobuf data.
uk: <varname>data</varname> вхідні дані FlatGeobuf.

note: Tag: title
en: Linear Referencing
uk: Лінійне посилання

note: Tag: refpurpose
en: Returns a point interpolated along a line at a fractional location.
uk: Повертає точку, інтерпольовану вздовж лінії в дробовому місці.

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.
uk: Повертає точку, інтерпольовану вздовж лінії в дробовому місці. Перший аргумент повинен бути LINESTRING. Другий аргумент — це число з плаваючою комою від 0 до 1, що позначає дрібну частину довжини лінії, де має бути розташована точка. Значення Z і M інтерполюються, якщо вони є.

note: Tag: para
en: See <xref linkend="ST_LineLocatePoint"/> for computing the line location nearest to a Point.
uk: Див. <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.
uk: <xref linkend="ST_3DLineInterpolatePoint"/> обчислює точки в 3D і інтерполює тільки значення 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.
uk: Починаючи з версії 1.1.1, ця функція також інтерполює значення M і Z (якщо вони присутні), тоді як у попередніх версіях вони встановлювалися на 0,0.

note: Tag: para
en: Availability: 0.8.2, Z and M supported added in 1.1.1
uk: Доступність: 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.
uk: Змінено: 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)
uk: LineString з інтерпольованою точкою в положенні 20% (0,20)

note: Tag: para
en: The mid-point of a 3D line:
uk: Середина 3D лінії:

note: Tag: para
en: The closest point on a line to a point:
uk: Найближча точка на прямій до точки:

note: Tag: refpurpose
en: Returns a point interpolated along a 3D line at a fractional location.
uk: Повертає точку, інтерпольовану вздовж 3D-лінії в дробовому місці.

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.
uk: Повертає точку, інтерпольовану вздовж 3D-лінії в дробовому місці. Перший аргумент повинен бути 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.
uk: обчислює точки в 2D, а потім інтерполює значення для Z і M, тоді як ця функція обчислює точки в 3D і інтерполює тільки значення M.

note: Tag: para
en: Return point 20% along 3D line
uk: Точка повернення 20% вздовж 3D лінії

note: Tag: refpurpose
en: Returns points interpolated along a line at a fractional interval.
uk: Повертає точки, інтерпольовані вздовж лінії з дробовим інтервалом.

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"/>.)
uk: Повертає одну або кілька точок, інтерпольованих вздовж лінії з дробовим інтервалом. Перший аргумент повинен бути 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.
uk: Якщо результат має нуль або один пункт, він повертається як POINT. Якщо він має два або більше пунктів, він повертається як MULTIPOINT.

note: Tag: para
en: A LineString with points interpolated every 20%
uk: Лінія String з точками, інтерпольованими кожні 20%

note: Tag: refpurpose
en: Returns the fractional location of the closest point on a line to a point.
uk: Повертає дробове значення відстані найближчої точки на лінії до заданої точки.

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.
uk: Повертає число з плаваючою комою в діапазоні від 0 до 1, що представляє розташування найближчої точки на LineString до заданої точки Point, як частку довжини <link linkend="ST_Length2D">2d line</link>.

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"/>).
uk: Ви можете використовувати повернуте місце розташування для вилучення точки (<xref linkend="ST_LineInterpolatePoint"/>) або підрядка (<xref linkend="ST_LineSubstring"/>).

note: Tag: para
en: This is useful for approximating numbers of addresses
uk: Це корисно для наближення кількості адрес

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Locate_Point.
uk: Змінено: 2.1.0. До версії 2.0.x це називалося ST_Line_Locate_Point.

note: Tag: refpurpose
en: Returns the part of a line between two fractional locations.
uk: Повертає частину лінії між двома дробовими позиціями.

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.
uk: Обчислює лінію, яка є ділянкою вхідної лінії, що починається і закінчується в заданих дробових точках. Перший аргумент повинен бути 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"/>.
uk: Якщо <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"/>.
uk: Це працює тільки з 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.
uk: Починаючи з версії 1.1.1, ця функція інтерполює значення M і Z. У попередніх версіях Z і M встановлювалися на невизначені значення.

note: Tag: para
en: Enhanced: 3.4.0 - Support for geography was introduced.
uk: Покращено: 3.4.0 - Додано підтримку географії.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Substring.
uk: Змінено: 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
uk: Доступність: 1.1.0, підтримка Z і M додана в 1.1.1

note: Tag: para
en: A LineString seen with 1/3 midrange overlaid (0.333, 0.666)
uk: Лінія LineString, на яку накладено 1/3 середнього діапазону (0,333, 0,666)

note: Tag: para
en: If start and end locations are the same, the result is a POINT.
uk: Якщо початкова та кінцева точки однакові, результатом є ТОЧКА.

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.
uk: Запит для розрізання LineString на секції довжиною 100 або менше. Він використовує <varname>generate_series()</varname> з CROSS JOIN LATERAL для створення еквівалента циклу FOR.

note: Tag: para
en: Geography implementation measures along a spheroid, geometry along a line
uk: Заходи з реалізації географії вздовж сфероїда, геометрія вздовж лінії

note: Tag: refpurpose
en: Returns the point(s) on a geometry that match a measure value.
uk: Повертає точку (точки) на геометрії, яка відповідає значенню міри.

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.
uk: Повертає місцезнаходження вздовж виміряної геометрії, яке має задані значення вимірювання. Результатом є точка або багатоточка. Полігональні вхідні дані не підтримуються.

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.
uk: Якщо вказано <varname>offset</varname>, результат буде зміщений вліво або вправо від лінії введення на вказану відстань. Позитивне зміщення буде вліво, а негативне — вправо.

note: Tag: para
en: Use this function only for linear geometries with an M component
uk: Використовуйте цю функцію тільки для лінійних геометрій з компонентом M

note: Tag: para
en: The semantic is specified by the <emphasis>ISO/IEC 13249-3 SQL/MM Spatial</emphasis> standard.
uk: Семантика визначається стандартом <emphasis>ISO/IEC 13249-3 SQL/MM Spatial</emphasis>.

note: Tag: para
en: Availability: 1.1.0 by old name ST_Locate_Along_Measure.
uk: Доступність: 1.1.0 під старою назвою ST_Locate_Along_Measure.

note: Tag: para
en: Changed: 2.0.0 in prior versions this used to be called ST_Locate_Along_Measure.
uk: Змінено: 2.0.0 у попередніх версіях це називалося ST_Locate_Along_Measure.

note: Tag: refpurpose
en: Returns the portions of a geometry that match a measure range.
uk: Повертає частини геометрії, які відповідають діапазону вимірювання.

note: Tag: para
en: Return a geometry (collection) with the portions of the input measured geometry that match the specified measure range (inclusively).
uk: Повернути геометрію (колекцію) з частинами виміряної геометрії вхідних даних, які відповідають заданому діапазону вимірювання (включно).

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.
uk: Якщо вказано <varname>offset</varname>, результат буде зміщений вліво або вправо від вхідної лінії на вказану відстань. Позитивне зміщення буде вліво, а негативне — вправо.

note: Tag: para
en: Clipping a non-convex POLYGON may produce invalid geometry.
uk: Обрізка не опуклого полігону може призвести до некоректної геометрії.

note: Tag: para
en: Availability: 1.1.0 by old name ST_Locate_Between_Measures.
uk: Доступність: 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.
uk: Змінено: 2.0.0 — у попередніх версіях ця функція називалася ST_Locate_Between_Measures.Змінено: 2.0.0 — у попередніх версіях ця функція називалася ST_Locate_Between_Measures.

note: Tag: para
en: Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE.
uk: Покращено: 3.0.0 - додано підтримку POLYGON, TIN, TRIANGLE.

note: Tag: para
en: A LineString with the section between measures 2 and 8, offset to the left
uk: LineString із відрізком між мірками 2 та 8, зміщений ліворуч

note: Tag: refpurpose
en: Returns the portions of a geometry that lie in an elevation (Z) range.
uk: Повертає частини геометрії, що лежать у діапазоні висоти (Z).

note: Tag: para
en: Returns a geometry (collection) with the portions of a geometry that lie in an elevation (Z) range.
uk: Повертає геометрію (колекцію) з частинами геометрії, що лежать у діапазоні висоти (Z).

note: Tag: para
en: Availability: 1.4.0
uk: Доступність: 1.4.0

note: Tag: refpurpose
en: Returns the interpolated measure of a geometry closest to a point.
uk: Повертає інтерпольоване значення геометрії, найближчої до точки.

note: Tag: para
en: Returns an interpolated measure value of a linear measured geometry at the location closest to the given point.
uk: Повертає інтерпольоване значення вимірювання лінійної геометрії в місці, найближчому до заданої точки.

note: Tag: refpurpose
en: Interpolates measures along a linear geometry.
uk: Інтерполює виміри вздовж лінійної геометрії.

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.
uk: Повертає похідну геометрію з лінійно інтерпольованими значеннями вимірювання між початковою та кінцевою точками. Якщо геометрія не має вимірювального виміру, він додається. Якщо геометрія має вимірювальний вимір, він перезаписується новими значеннями. Підтримуються лише LINESTRINGS та MULTILINESTRINGS.

note: Tag: title
en: Table Management Functions
uk: Функції управління таблицями

note: Tag: para
en: These functions assist in defining tables containing geometry columns.
uk: Ці функції допомагають визначати таблиці, що містять стовпці геометрії.

note: Tag: refpurpose
en: Adds a geometry column to an existing table.
uk: Додає стовпець геометрії до існуючої таблиці.

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.
uk: Додає стовпець геометрії до існуючої таблиці атрибутів. <varname>schema_name</varname> — це ім'я схеми таблиці. <varname>srid</varname> має бути цілочисельним значенням, що посилається на запис у таблиці SPATIAL_REF_SYS. <varname>type</varname> повинен бути рядком, що відповідає типу геометрії, наприклад, “POLYGON” або “MULTILINESTRING” . Якщо schema_name не існує (або не видно в поточному 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>
uk: Змінено: 2.0.0 Ця функція більше не оновлює geometry_columns, оскільки geometry_columns є поданням, яке зчитує дані з системних каталогів. За замовчуванням вона також не створює обмежень, а замість цього використовує вбудовану поведінку модифікатора типу PostgreSQL. Наприклад, створення стовпця wgs84 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.
uk: Змінено: 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"/>.
uk: Змінено: 2.0.0 Види більше не можна реєструвати вручну в geometry_columns, однак види, побудовані на основі геометрій таблиць типу typmod і використовувані без функцій-обгортки, реєструватимуться правильно, оскільки вони успадковують поведінку типу typmod стовпця батьківської таблиці. Види, які використовують функції геометрії, що виводять інші геометрії, потрібно буде перетворити на геометрії типу typmod, щоб ці стовпці геометрії виду були зареєстровані правильно в geometry_columns. Див. <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.
uk: Покращено: 2.0.0 Додано аргумент use_typmod. За замовчуванням створюється стовпець геометрії typmod замість стовпця на основі обмежень.

note: Tag: refpurpose
en: Removes a geometry column from a spatial table.
uk: Видаляє стовпець геометрії з просторової таблиці.

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.
uk: Видаляє стовпець геометрії з просторової таблиці. Зверніть увагу, що schema_name повинен відповідати полю f_table_schema рядка таблиці в таблиці geometry_columns.

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>
uk: Змінено: 2.0.0 Ця функція надається для забезпечення зворотної сумісності. Тепер, коли geometry_columns є видом системних каталогів, ви можете видалити стовпець geometry так само, як і будь-який інший стовпець таблиці, за допомогою <code>ALTER TABLE</code>

note: Tag: refpurpose
en: Drops a table and all its references in geometry_columns.
uk: Видаляє таблицю та всі її посилання в 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.
uk: Видаляє таблицю та всі її посилання в geometry_columns. Примітка: використовує current_schema() в установках pgsql, що підтримують схеми, якщо схема не вказана.

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>
uk: Змінено: 2.0.0 Ця функція надається для забезпечення зворотної сумісності. Тепер, коли geometry_columns є переглядом системних каталогів, ви можете видалити таблицю з геометричними стовпцями, як і будь-яку іншу таблицю, за допомогою <code>DROP TABLE</code>

note: Tag: refpurpose
en: Returns the SRID defined for a geometry column.
uk: Повертає 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.
uk: Повертає ціле значення SRID вказаного стовпця геометрії, шукаючи його в таблиці GEOMETRY_COLUMNS. Якщо стовпець геометрії не був доданий належним чином (наприклад, за допомогою функції <xref linkend="AddGeometryColumn"/>), ця функція не працюватиме.

note: Tag: refpurpose
en: Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
uk: Забезпечує, щоб стовпці геометрії були визначені з модифікаторами типу або мали відповідні просторові обмеження.

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.
uk: Забезпечує, щоб стовпці геометрії мали відповідні модифікатори типу або просторові обмеження, щоб гарантувати їх правильну реєстрацію в перегляді <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:
uk: Для забезпечення зворотної сумісності та для просторових потреб, таких як успадкування таблиць, де кожна дочірня таблиця може мати різний тип геометрії, все ще підтримується старе поведінка перевірки обмежень. Якщо вам потрібна стара поведінка, потрібно передати новий необов'язковий аргумент як false <varname>use_typmod=false</varname>. Після цього стовпці геометрії будуть створені без модифікаторів типу, але з 3 визначеними обмеженнями. Зокрема, це означає, що кожен стовпець геометрії, що належить до таблиці, має принаймні три обмеження:

note: Tag: para
en: <varname>enforce_dims_geom</varname> - ensures every geometry has the same dimension (see <xref linkend="ST_NDims"/>)
uk: <varname>enforce_dims_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"/>)
uk: <varname>enforce_geotype_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"/>)
uk: <varname>enforce_srid_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.
uk: Якщо вказано таблицю <varname>oid</varname>, ця функція намагається визначити srid, розмірність та тип геометрії всіх стовпців геометрії в таблиці, додаючи обмеження за необхідності. У разі успіху відповідний рядок вставляється в таблицю geometry_columns, інакше виникає виняток і з'являється повідомлення про помилку з описом проблеми.

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.
uk: Якщо вказано <varname>oid</varname> перегляду, як і в разі табличного oid, ця функція намагається визначити srid, розмірність і тип усіх геометрій у перегляді, вставляючи відповідні записи в таблицю <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.
uk: Варіант без параметрів є простим обгорткою для параметризованого варіанту, який спочатку обрізає і заповнює таблицю geometry_columns для кожної просторової таблиці і перегляду в базі даних, додаючи просторові обмеження до таблиць, де це доречно. Він повертає підсумок кількості стовпців геометрії, виявлених в базі даних, і кількості, які були вставлені в таблицю <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.
uk: Змінено: 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.
uk: Покращено: 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.
uk: Оновлює 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.
uk: Оновлює SRID всіх об'єктів у стовпці геометрії, оновлюючи обмеження та посилання в geometry_columns. Якщо стовпець був застосований за допомогою визначення типу, визначення типу буде змінено. Примітка: використовує current_schema() в установках pgsql, що підтримують схеми, якщо схема не вказана.

note: Tag: para
en: Insert geometries into roads table with a SRID set already using <link linkend="ST_GeomFromEWKT">EWKT format</link>:
uk: Вставте геометрії в таблицю доріг із вже встановленим SRID, використовуючи формат <link linkend="ST_GeomFromEWKT">EWKT</link>:

note: Tag: para
en: This will change the srid of the roads table to 4326 from whatever it was before:
uk: Це змінить srid таблиці доріг на 4326 з будь-якого попереднього значення:

note: Tag: para
en: The prior example is equivalent to this DDL statement:
uk: Попередній приклад еквівалентний цій DDL-інструкція:

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.
uk: Якщо ви неправильно вказали проекцію (або вказали її як невідому) під час завантаження і хочете перетворити все в веб-меркатор за один раз, ви можете зробити це за допомогою DDL, але в PostGIS немає еквівалентної функції для виконання цієї операції за один раз.

note: Tag: title
en: Measurement Functions
uk: Функції вимірювання

note: Tag: para
en: These functions compute measurements of distance, area and angles. There are also functions to compute geometry values determined by measurements.
uk: Ці функції обчислюють відстані, площі та кути. Існують також функції для обчислення геометричних величин, визначених за вимірами.

note: Tag: refpurpose
en: Returns the area of a polygonal geometry.
uk: Повертає площу полігональної геометрії.

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>.
uk: Повертає площу полігональної геометрії. Для типів геометрії обчислюється площина 2D (плоска) з одиницями, визначеними SRID. Для типів географії за замовчуванням площа визначається на сфероїді з одиницями в квадратних метрах. Для обчислення площі за допомогою швидшої, але менш точної сферичної моделі використовуйте <varname>ST_Area(geog,false)</varname>.

note: Tag: para
en: Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced.
uk: Покращено: 2.0.0 - додано підтримку 2D багатогранних поверхонь.

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.
uk: Покращено: 2.2.0 — вимірювання на сфероїді виконується за допомогою GeographicLib для підвищення точності та надійності. Для використання нової функції потрібно PROJ &gt;= 4.9.0.

note: Tag: para
en: Changed: 3.0.0 - does not depend on SFCGAL anymore.
uk: Змінено: 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.
uk: Для багатогранних поверхонь підтримуються тільки 2D багатогранні поверхні (не 2.5D). Для 2.5D може бути надано відповідь, відмінну від нуля, але тільки для граней, які повністю лежать у площині 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
uk: Площа ділянки в квадратних футах для ділянки землі в штаті Массачусетс і помножте на коефіцієнт перетворення, щоб отримати квадратні метри. Зверніть увагу, що це квадратні фути, оскільки 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
uk: Введіть площу в квадратних футах і переведіть її в метри площини штату Массачусетс (EPSG:26986), щоб отримати площу в квадратних метрах. Зверніть увагу, що значення вказано в квадратних футах, оскільки 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.
uk: Поверніть площу в квадратних футах і квадратних метрах, використовуючи тип даних "географія". Зверніть увагу, що ми перетворюємо геометрію в географію (перед тим, як це зробити, переконайтеся, що ваша геометрія відповідає стандарту WGS 84 long lat 4326). Географія завжди вимірюється в метрах. Це лише для демонстрації та порівняння. Зазвичай ваша таблиця вже зберігається в типі даних "географія".

note: Tag: para
en: If your data is in geography already:
uk: Якщо ваші дані вже знаходяться в географії:

note: Tag: refpurpose
en: Returns the north-based azimuth of a line between two points.
uk: Повертає азимут на північ від лінії між двома точками.

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.
uk: Повертає азимут в радіанах від точки відліку до точки призначення або 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>.
uk: Для типу географії рішення азимута відоме як <link xlink:href="https://en.wikipedia.org/wiki/Geodesics_on_an_ellipsoid">обернена геодезична задача</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>.
uk: Азимут — це математичне поняття, яке визначається як кут між опорним вектором і точкою, вимірюється в радіанах. Результат у радіанах можна перетворити в градуси за допомогою функції 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.
uk: Азимут можна використовувати разом з <xref linkend="ST_Translate"/> для зміщення об'єкта вздовж його перпендикулярної осі. Дивіться функцію <varname>upgis_lineshift()</varname> у <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctions">PostGIS wiki</link> для реалізації цього.

note: Tag: para
en: Enhanced: 2.0.0 support for geography was introduced.
uk: Покращено: 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.
uk: Покращено: вимірювання 2.2.0 на сфероїді, виконане за допомогою GeographicLib для підвищення точності та надійності. Для використання нової функції потрібно PROJ &gt;= 4.9.0.

note: Tag: para
en: Geometry Azimuth in degrees
uk: Геометрія Азимут у градусах

note: Tag: para
en: Blue: origin Point(25,45); Green: target Point(75, 100); Yellow: Y axis or North; Red: azimuth angle.
uk: Синій: точка відліку (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.
uk: Синій: точка відліку (75, 100); Зелений: точка призначення (25, 45); Жовтий: вісь Y або північ; Червоний: кут азимута.

note: Tag: para
en: , <xref linkend="ST_Point"/>, <xref linkend="ST_Translate"/>, <xref linkend="ST_Project"/>, <link xlink:href="http://www.postgresql.org/docs/current/interactive/functions-math.html">PostgreSQL Math Functions</link>
uk: , <xref linkend="ST_Point"/>, <xref linkend="ST_Translate"/>, <xref linkend="ST_Project"/>, <link xlink:href="http://www.postgresql.org/docs/current/interactive/functions-math.html">Математичні функції PostgreSQL</link>

note: Tag: refpurpose
en: Returns the angle between two vectors defined by 3 or 4 points, or 2 lines.
uk: Повертає кут між двома векторами, визначеними 3 або 4 точками, або 2 лініями.

note: Tag: para
en: Computes the clockwise angle between two vectors.
uk: Обчислює кут за годинниковою стрілкою між двома векторами.

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
uk: <emphasis role="bold">Варіант 1:</emphasis> обчислює кут, утворений точками P1-P2-P3. Якщо вказано четверту точку, обчислюється кут між точками 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
uk: <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>.
uk: Результатом є позитивний кут між 0 і 2&#x03C0; радіанами. Результат у радіанах можна перетворити на градуси за допомогою функції PostgreSQL <varname>degrees()</varname>.

note: Tag: para
en: Note that <varname>ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)</varname>.
uk: Зверніть увагу, що <varname>ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)</varname>.

note: Tag: para
en: Angle between three points
uk: Кут між трьома точками

note: Tag: para
en: Angle between vectors defined by four points
uk: Кут між векторами, визначеними чотирма точками

note: Tag: para
en: Angle between vectors defined by the start and end points of lines
uk: Кут між векторами, визначеними початковою та кінцевою точками ліній

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.
uk: Повертає 2D точку на g1, яка найближча до g2. Це перша точка найкоротшої лінії від однієї геометрії до іншої.

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"/>).
uk: Повертає двовимірну точку на <varname>geom1</varname>, яка найближча до <varname>geom2</varname>. Це перша точка найкоротшої лінії між геометріями (розрахована за допомогою <xref linkend="ST_ShortestLine"/>).

note: Tag: para
en: If you have a 3D Geometry, you may prefer to use <xref linkend="ST_3DClosestPoint"/>.
uk: Якщо у вас є 3D-геометрія, ви можете скористатися <xref linkend="ST_3DClosestPoint"/>.

note: Tag: para
en: Enhanced: 3.4.0 - Support for geography.
uk: Покращено: 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.
uk: Найближчою точкою для точки та лінійного елемента є сама точка. Найближчою точкою для лінійного елемента та точки є точка на лінії.

note: Tag: para
en: The closest point on polygon A to polygon B
uk: Найближча точка полігону 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.
uk: Повертає 3D точку на g1, яка найближча до g2. Це перша точка найкоротшої 3D лінії.

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.
uk: Повертає тривимірну точку на g1, яка найближча до g2. Це перша точка найкоротшої лінії в 3D. Довжина найкоротшої лінії в 3D є відстанню в 3D.

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.
uk: Змінено: 2.2.0 - якщо введено 2 2D геометрії, повертається 2D точка (замість старого поведінки, що припускає 0 для відсутнього Z). У випадку 2D і 3D, Z більше не вважається 0 для відсутнього Z.

note: Tag: para
en: linestring and point -- both 3d and 2d closest point
uk: лінія та точка — як 3D, так і 2D найближча точка

note: Tag: para
en: linestring and multipoint -- both 3d and 2d closest point
uk: лінія та багатоточка — як 3D, так і 2D найближча точка

note: Tag: para
en: Multilinestring and polygon both 3d and 2d closest point
uk: Багатолінійні та полігони, як 3D, так і 2D, найближчі точки

note: Tag: refpurpose
en: Returns the distance between two geometry or geography values.
uk: Повертає відстань між двома геометричними або географічними значеннями.

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).
uk: Для типів <xref linkend="geometry"/> повертає мінімальну 2D декартову (плоску) відстань між двома геометріями в проекційних одиницях (одиницях просторової прив'язки).

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.
uk: Для типів <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
uk: Доступність: 1.5.0 Підтримка географії була впроваджена в версії 1.5. Покращення швидкості для плоских об'єктів для кращої обробки великих або численних вершин геометрії

note: Tag: para
en: Enhanced: 2.1.0 improved speed for geography. See <link xlink:href="https://web.archive.org/web/20160827203903/http://boundlessgeo.com/2012/07/making-geography-faster/">Making Geography faster</link> for details.
uk: Покращено: 2.1.0 покращено швидкість роботи з географією. Детальніше див. <link xlink:href="https://web.archive.org/web/20160827203903/http://boundlessgeo.com/2012/07/making-geography-faster/">Пришвидшення роботи з географією</link>.

note: Tag: para
en: Enhanced: 2.1.0 - support for curved geometries was introduced.
uk: Покращено: 2.1.0 — додано підтримку кривих геометрій.

note: Tag: title
en: Geometry Examples
uk: Приклади геометрії

note: Tag: para
en: Geometry example - units in planar degrees 4326 is WGS 84 long lat, units are degrees.
uk: Приклад геометрії - одиниці виміру в плоских градусах 4326 - це довжина в градусах за системою WGS 84, одиниці виміру - градуси.

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.
uk: Приклад геометрії — одиниці виміру в метрах (SRID: 3857, пропорційно до пікселів на популярних веб-мапах). Хоча значення не відповідає дійсності, сусідні значення можна порівняти правильно, що робить цей вибір хорошим для таких алгоритмів, як KNN або KMeans.

note: Tag: para
en: Geometry example - units in meters (SRID: 3857 as above, but corrected by cos(lat) to account for distortion)
uk: Приклад геометрії — одиниці виміру в метрах (SRID: 3857, як вище, але скориговано за допомогою cos(lat) для врахування спотворення)

note: Tag: para
en: Geometry example - units in meters (SRID: 26986 Massachusetts state plane meters) (most accurate for Massachusetts)
uk: Приклад геометрії — одиниці виміру в метрах (SRID: 26986 метри площини штату Массачусетс) (найточніше для штату Массачусетс)

note: Tag: para
en: Geometry example - units in meters (SRID: 2163 US National Atlas Equal area) (least accurate)
uk: Приклад геометрії — одиниці виміру в метрах (SRID: 2163 US National Atlas Equal area) (найменша точність)

note: Tag: title
en: Geography Examples
uk: Приклади з географії

note: Tag: para
en: Same as geometry example but note units in meters - use sphere for slightly faster and less accurate computation.
uk: Те саме, що й у прикладі з геометрією, але зверніть увагу на одиниці виміру в метрах — для трохи швидшого та менш точного обчислення використовуйте сферу.

note: Tag: refpurpose
en: Returns the 3D cartesian minimum distance (based on spatial ref) between two geometries in projected units.
uk: Повертає мінімальну 3D декартову відстань (на основі просторової референції) між двома геометріями в проекційних одиницях.

note: Tag: para
en: Returns the 3-dimensional minimum cartesian distance between two geometries in projected units (spatial ref units).
uk: Повертає 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.
uk: Змінено: 2.2.0 - У випадку 2D та 3D, Z більше не вважається рівним 0 для відсутнього Z.

note: Tag: para
en: Changed: 3.0.0 - SFCGAL version removed
uk: Змінено: 3.0.0 - Вилучено версію SFCGAL

note: Tag: refpurpose
en: Returns minimum distance in meters between two lon/lat geometries using a spherical earth model.
uk: Повертає мінімальну відстань у метрах між двома геометріями довготи/широти, використовуючи модель сферичної Землі.

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.
uk: Повертає мінімальну відстань у метрах між двома точками lon/lat. Використовує сферичну Землю та радіус, отриманий із сфероїда, визначеного 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.
uk: Доступність: 1.5 — додано підтримку інших типів геометрії, крім точок. Попередні версії працюють тільки з точками.

note: Tag: para
en: Changed: 2.2.0 In prior versions this used to be called ST_Distance_Sphere
uk: Змінено: 2.2.0 У попередніх версіях це називалося ST_Distance_Sphere

note: Tag: refpurpose
en: Returns the minimum distance between two lon/lat geometries using a spheroidal earth model.
uk: Повертає мінімальну відстань між двома геометріями lon/lat, використовуючи сфероїдальну модель Землі.

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"/>.
uk: Повертає мінімальну відстань у метрах між двома геометріями lon/lat, заданими для певного сфероїда. Див. пояснення сфероїдів, наведене для <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.
uk: Ця функція не враховує SRID геометрії. Вона припускає, що координати геометрії базуються на наданому сфероїді.

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Distance_Spheroid
uk: Змінено: 2.2.0 У попередніх версіях це називалося ST_Distance_Spheroid

note: Tag: refpurpose
en: Returns the Fréchet distance between two geometries.
uk: Повертає відстань Фреше між двома геометріями.

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.
uk: Реалізує алгоритм обчислення відстані Фреше, обмеженої дискретними точками для обох геометрій, на основі <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.
uk: Коли вказано опціональний параметр densifyFrac, ця функція виконує ущільнення сегментів перед обчисленням дискретної відстані Фреше. Параметр densifyFrac встановлює частку, на яку ущільнюється кожен сегмент. Кожен сегмент буде розділений на декілька підсегментів однакової довжини, частка яких у загальній довжині найближча до заданої частки.

note: Tag: para
en: Units are in the units of the spatial reference system of the geometries.
uk: Одиниці вимірювання відповідають одиницям просторової системи координат геометрії.

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.
uk: Поточна реалізація підтримує тільки вершини як дискретні місця розташування. Це можна розширити, щоб дозволити використання довільної щільності точок.

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.
uk: Чим менше значення densifyFrac ми вказуємо, тим точніше буде відстань Фреше. Однак час обчислення та використання пам'яті зростають пропорційно до квадрату кількості підсегментів.

note: Tag: refpurpose
en: Returns the Hausdorff distance between two geometries.
uk: Повертає відстань Гаусдорфа між двома геометріями.

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.
uk: Повертає <link xlink:href="http://en.wikipedia.org/wiki/Hausdorff_distance">відстань Гаусдорфа</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.
uk: Функція фактично обчислює "дискретну відстань Гаусдорфа". Це відстань Гаусдорфа, обчислена в дискретних точках геометрії. Параметр <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.
uk: Цей алгоритм НЕ є еквівалентним стандартній відстані Гаусдорфа. Однак він обчислює наближення, яке є правильним для великої підмножини корисних випадків. Одним з важливих випадків є лінійні рядки, які приблизно паралельні один одному і мають приблизно однакову довжину. Це корисний показник для зіставлення ліній.

note: Tag: para
en: Hausdorff distance (red) and distance (yellow) between two lines
uk: Відстань Гаусдорфа (червоний) і відстань (жовтий) між двома лініями

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Hausdorff distance with densification.
uk: <emphasis role="bold">Приклад:</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.
uk: <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.
uk: Повертає 2D довжину лінійної геометрії.

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.
uk: Для типів геометрії: повертає двовимірну декартову довжину геометрії, якщо це LineString, MultiLineString, ST_Curve, ST_MultiCurve. Для плоских геометрій повертається 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.
uk: Для географічних типів: обчислення виконується за допомогою оберненого геодезичного розрахунку. Одиниці довжини вказані в метрах. Якщо PostGIS скомпільовано з PROJ версії 4.8.0 або пізнішої, сфероїд визначається за 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.
uk: Наразі для геометрії це псевдонім для 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
uk: Змінено: 2.0.0 Істотна зміна — у попередніх версіях застосування цього до MULTI/POLYGON типу geography давало периметр 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);
uk: Для географії за замовчуванням використовується сфероїдальна модель. Щоб скористатися швидшим, але менш точним сферичним розрахунком, використовуйте ST_Length(gg,false);

note: Tag: para
en: Availability: 1.5.0 geography support was introduced in 1.5.
uk: Доступність: підтримка географії 1.5.0 була введена в версії 1.5.

note: Tag: para
en: Return length in feet for line string. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet
uk: Довжина повернення в футах для рядка рядка. Зверніть увагу, що це в футах, оскільки EPSG:2249 - це фути штату Массачусетс

note: Tag: para
en: Return length of WGS 84 geography line
uk: Повернути довжину географічної лінії WGS 84

note: Tag: refpurpose
en: Returns the 2D length of a linear geometry. Alias for <varname>ST_Length</varname>
uk: Повертає 2D довжину лінійної геометрії. Псевдонім для <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>
uk: Повертає 2D довжину геометрії, якщо це лінія або багатолінійна лінія. Це псевдонім для <varname>ST_Length</varname>

note: Tag: refpurpose
en: Returns the 3D length of a linear geometry.
uk: Повертає 3D довжину лінійної геометрії.

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)
uk: Повертає тривимірну або двовимірну довжину геометрії, якщо це LineString або MultiLineString. Для двовимірних ліній повертається лише двовимірна довжина (так само, як ST_Length і ST_Length2D)

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Length3D
uk: Змінено: 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
uk: Довжина повернення в футах для 3D-кабелю. Зверніть увагу, що це в футах, оскільки EPSG:2249 — це фути штату Массачусетс

note: Tag: refpurpose
en: Returns the 2D or 3D length/perimeter of a lon/lat geometry on a spheroid.
uk: Повертає 2D або 3D довжину/периметр геометрії lon/lat на сфероїді.

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:
uk: Обчислює довжину або периметр геометрії на еліпсоїді. Це корисно, якщо координати геометрії задані в градусах довготи/широти, а довжина потрібна без перепроекції. Сфероїд задається текстовим значенням у такому форматі:

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Length_Spheroid and had the alias ST_3DLength_Spheroid
uk: Змінено: 2.2.0 У попередніх версіях ця функція називалася ST_Length_Spheroid і мала псевдонім ST_3DLength_Spheroid

note: Tag: refpurpose
en: Returns the 2D longest line between two geometries.
uk: Повертає найдовшу 2D лінію між двома геометріями.

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>.
uk: Повертає найдовшу двовимірну лінію між точками двох геометрій. Повернена лінія починається в точці <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"/>.
uk: Найдовша лінія завжди проходить між двома вершинами. Якщо знайдено більше однієї лінії, функція повертає першу найдовшу лінію. Довжина лінії дорівнює відстані, поверненій функцією <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"/>.
uk: Якщо g1 і g2 мають однакову геометрію, повертає лінію між двома найвіддаленішими вершинами в геометрії. Кінцеві точки лінії лежать на колі, обчисленому за допомогою <xref linkend="ST_MinimumBoundingCircle"/>.

note: Tag: para
en: Longest line between a point and a line
uk: Найдовша лінія між точкою і прямою

note: Tag: para
en: Longest line between two polygons
uk: Найдовша лінія між двома полігонами

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.
uk: Найдовша лінія, що проходить через одну геометрію. Довжина лінії дорівнює максимальній відстані. Кінцеві точки лінії лежать на мінімальному обмежувальному колі.

note: Tag: refpurpose
en: Returns the 3D longest line between two geometries
uk: Повертає найдовшу 3D лінію між двома геометріями

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"/>.
uk: Повертає найдовшу тривимірну лінію між двома геометріями. Якщо таких ліній більше однієї, функція повертає першу найдовшу лінію. Повернена лінія починається в g1 і закінчується в g2. Тривимірна довжина лінії дорівнює відстані, поверненій функцією <xref linkend="ST_3DMaxDistance"/>.

note: Tag: para
en: linestring and point -- both 3d and 2d longest line
uk: лінія та точка — найдовша лінія у 3D та 2D

note: Tag: para
en: linestring and multipoint -- both 3d and 2d longest line
uk: лінія та мультиточка — найдовша лінія в 3D та 2D

note: Tag: para
en: MultiLineString and Polygon both 3d and 2d longest line
uk: MultiLineString і Polygon, як 3D, так і 2D найдовша лінія

note: Tag: refpurpose
en: Returns the 2D largest distance between two geometries in projected units.
uk: Повертає найбільшу відстань між двома геометріями в проекційних одиницях.

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"/>.
uk: Повертає максимальну відстань між двома геометріями у двовимірному просторі, в проекційних одиницях. Максимальна відстань завжди виникає між двома вершинами. Це довжина лінії, повернена функцією <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.
uk: Якщо g1 і g2 мають однакову геометрію, повертає відстань між двома найвіддаленішими вершинами в цій геометрії.

note: Tag: para
en: Maximum distance between a point and lines.
uk: Максимальна відстань між точкою та лініями.

note: Tag: para
en: Maximum distance between vertices of a single geometry.
uk: Максимальна відстань між вершинами однієї геометрії.

note: Tag: refpurpose
en: Returns the 3D cartesian maximum distance (based on spatial ref) between two geometries in projected units.
uk: Повертає максимальну 3D-відстань (на основі просторової референції) між двома геометріями в проекційних одиницях.

note: Tag: para
en: Returns the 3-dimensional maximum cartesian distance between two geometries in projected units (spatial ref units).
uk: Повертає тривимірну максимальну декартову відстань між двома геометріями в проекційних одиницях (одиницях просторової прив'язки).

note: Tag: refpurpose
en: Returns the minimum clearance of a geometry, a measure of a geometry's robustness.
uk: Повертає мінімальний зазор геометрії, міру міцності геометрії.

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).
uk: Геометрія може відповідати критеріям валідності згідно з <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.
uk: Мінімальний зазор — це кількісна міра стійкості геометрії до зміни точності координат. Це найбільша відстань, на яку можна перемістити вершини геометрії, не порушуючи її цілісності. Більші значення мінімального зазору вказують на більшу стійкість.

note: Tag: para
en: If a geometry has a minimum clearance of <varname>e</varname>, then:
uk: Якщо геометрія має мінімальний зазор <varname>e</varname>, то:

note: Tag: para
en: No two distinct vertices in the geometry are closer than the distance <varname>e</varname>.
uk: У геометрії немає двох різних вершин, відстань між якими менша за <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.
uk: Жодна вершина не знаходиться ближче, ніж <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>.
uk: Якщо для геометрії не існує мінімального зазору (наприклад, для окремої точки або для 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.
uk: Щоб уникнути проблем з валідністю, спричинених втратою точності, <xref linkend="ST_ReducePrecision"/>може зменшити точність координат, гарантуючи при цьому валідність полігональної геометрії.

note: Tag: refpurpose
en: Returns the two-point LineString spanning a geometry's minimum clearance.
uk: Повертає двоточкову лінію LineString, що охоплює мінімальний простір геометрії.

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.
uk: Повертає двоточкову лінію LineString, що охоплює мінімальний зазор геометрії. Якщо геометрія не має мінімального зазору, повертається <varname>LINESTRING EMPTY</varname>.

note: Tag: para
en: Availability: 2.3.0 - requires GEOS &gt;= 3.6.0
uk: Доступність: 2.3.0 - вимагає GEOS &gt;= 3.6.0

note: Tag: refpurpose
en: Returns the length of the boundary of a polygonal geometry or geography.
uk: Повертає довжину межі полігональної геометрії або географії.

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.
uk: Повертає 2D периметр геометрії/географії, якщо це ST_Surface, ST_MultiSurface (Polygon, MultiPolygon). Для геометрій, що не мають площі, повертається 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.
uk: Для географічних типів обчислення виконуються за допомогою оберненої геодезичної задачі, де одиниці периметра вимірюються в метрах. Якщо 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.
uk: Наразі це псевдонім для ST_Perimeter2D, але це може змінитися для підтримки вищих вимірів.

note: Tag: para
en: Availability 2.0.0: Support for geography was introduced
uk: Доступність 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
uk: Повернути периметр у футах для полігону та мультиполігону. Зверніть увагу, що це фути, оскільки EPSG:2249 — це фути штату Массачусетс.

note: Tag: para
en: Return perimeter in meters and feet for Polygon and MultiPolygon. Note this is geography (WGS 84 long lat)
uk: Повернути периметр у метрах і футах для полігону та мультиполігону. Зверніть увагу, що це географічні координати (WGS 84 long lat)

note: Tag: refpurpose
en: Returns the 2D perimeter of a polygonal geometry. Alias for <varname>ST_Perimeter</varname>.
uk: Повертає 2D периметр полігональної геометрії. Псевдонім для <varname>ST_Perimeter</varname>.

note: Tag: para
en: Returns the 2-dimensional perimeter of a polygonal geometry.
uk: Повертає двовимірний периметр багатокутної геометрії.

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
uk: Наразі це псевдонім для ST_Perimeter. У майбутніх версіях ST_Perimeter може повертати найбільший периметр для геометрії. Це питання ще розглядається

note: Tag: refpurpose
en: Returns the 3D perimeter of a polygonal geometry.
uk: Повертає 3D периметр полігональної геометрії.

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.
uk: Повертає тривимірний периметр геометрії, якщо це полігон або мультиполігон. Якщо геометрія двовимірна, то повертається двовимірний периметр.

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D
uk: Змінено: 2.0.0 У попередніх версіях це називалося ST_Perimeter3D

note: Tag: para
en: Perimeter of a slightly elevated polygon in the air in Massachusetts state plane feet
uk: Периметр злегка піднятого полігону в повітрі в штаті Массачусетс, фути площини штату

note: Tag: refpurpose
en: Returns the 2D shortest line between two geometries
uk: Повертає найкоротшу 2D лінію між двома геометріями

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.
uk: Повертає найкоротшу двовимірну лінію між двома геометріями. Повернена лінія починається в <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.
uk: Покращено: 3.4.0 - підтримка географії.

note: Tag: para
en: Shortest line between Point and LineString
uk: Найкоротша лінія між точкою та лінією

note: Tag: para
en: Shortest line between Polygons
uk: Найкоротша лінія між полігонами

note: Tag: refpurpose
en: Returns the 3D shortest line between two geometries
uk: Повертає найкоротшу 3D лінію між двома геометріями

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.
uk: Повертає найкоротшу тривимірну лінію між двома геометріями. Якщо функція знаходить більше однієї найкоротшої лінії, вона повертає тільки першу. Якщо g1 і g2 перетинаються тільки в одній точці, функція повертає лінію, початок і кінець якої знаходяться в цій точці перетину. Якщо g1 і g2 перетинаються в більш ніж одній точці, функція поверне лінію, початок і кінець якої знаходяться в одній точці, але це може бути будь-яка з точок перетину. Повернена лінія завжди починатиметься в g1 і закінчуватиметься в g2. Тривимірна довжина лінії, яку повертає ця функція, завжди буде такою ж, як <xref linkend="ST_3DDistance"/>повертає для g1 і g2.

note: Tag: para
en: linestring and point -- both 3d and 2d shortest line
uk: лінія та точка — найкоротша лінія в 3D та 2D

note: Tag: para
en: linestring and multipoint -- both 3d and 2d shortest line
uk: лінія та мультиточка — найкоротша лінія в 3D та 2D

note: Tag: para
en: MultiLineString and polygon both 3d and 2d shortest line
uk: MultiLineString і полігон, як 3D, так і 2D найкоротша лінія

note: Tag: title
en: Operators
uk: Оператори

note: Tag: title
en: Bounding Box Operators
uk: Оператори обмежувальної рамки

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's 2D bounding box intersects B's 2D bounding box.
uk: Повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка A перетинається з 2D обмежувальною рамкою B.

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.
uk: Оператор <varname>&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка геометрії A перетинає 2D обмежувальну рамку геометрії B.

note: Tag: para
en: This operand will make use of any indexes that may be available on the geometries.
uk: Цей операнд буде використовувати будь-які індекси, які можуть бути доступні для геометрій.

note: Tag: para
en: Availability: 1.5.0 support for geography was introduced.
uk: Доступність: 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).
uk: Повертає <varname>TRUE</varname>, якщо (кешована) 2D обмежувальна рамка геометрії перетинає 2D обмежувальну рамку з плаваючою точністю (BOX2DF).

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)
uk: Оператор <varname>&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо кешована 2D обмежувальна рамка геометрії A перетинає 2D обмежувальну рамку B, використовуючи точність float. Це означає, що якщо B є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (BOX2DF)

note: Tag: para
en: This operand is intended to be used internally by BRIN indexes, more than by users.
uk: Цей операнд призначений для внутрішнього використання індексами BRIN, а не користувачами.

note: Tag: para
en: Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+.
uk: Доступність: 2.3.0 додано підтримку індексів діапазону блоків (BRIN). Потрібна 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.
uk: Повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка з плаваючою точністю (BOX2DF) перетинає (кешовану) 2D обмежувальну рамку геометрії.

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)
uk: Оператор <varname>&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка A перетинає кешовану 2D обмежувальну рамку геометрії B, використовуючи точність float. Це означає, що якщо A є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if two 2D float precision bounding boxes (BOX2DF) intersect each other.
uk: Повертає <varname>TRUE</varname>, якщо дві обмежувальні рамки 2D з плаваючою точністю (BOX2DF) перетинаються між собою.

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)
uk: Оператор <varname>&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо дві 2D обмежувальні рамки A і B перетинаються, використовуючи точність float. Це означає, що якщо A (або B) є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку (BOX2DF) з точністю float

note: Tag: para
en: This operator is intended to be used internally by BRIN indexes, more than by users.
uk: Цей оператор призначений для внутрішнього використання індексами BRIN, а не користувачами.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's n-D bounding box intersects B's n-D bounding box.
uk: Повертає <varname>TRUE</varname>, якщо n-D обмежувальна рамка A перетинається з n-D обмежувальною рамкою B.

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.
uk: Оператор <varname>&amp;&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо n-вимірна обмежувальна рамка геометрії A перетинає n-вимірну обмежувальну рамку геометрії B.

note: Tag: title
en: Examples: 3D LineStrings
uk: Приклади: 3D лінійні об'єкти

note: Tag: title
en: Examples: 3M LineStrings
uk: Приклади: 3M LineStrings

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).
uk: Повертає <varname>TRUE</varname>, якщо (кешована) n-вимірна обмежувальна рамка геометрії перетинає n-вимірну обмежувальну рамку з плаваючою точністю (GIDX).

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)
uk: Оператор <varname>&amp;&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо кешована n-вимірна обмежувальна рамка геометрії A перетинає n-вимірну обмежувальну рамку B, використовуючи точність float. Це означає, що якщо B є (подвійної точності) box3d, вона буде внутрішньо перетворена в обмежувальну рамку 3D з точністю float (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.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка з n-вимірною точністю (GIDX) перетинає (кешовану) n-вимірну обмежувальну рамку геометрії.

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)
uk: Оператор <varname>&amp;&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо n-вимірна обмежувальна рамка A перетинає кешовану n-вимірну обмежувальну рамку геометрії B, використовуючи точність float. Це означає, що якщо A є (подвійної точності) box3d, вона буде внутрішньо перетворена в 3D обмежувальну рамку (GIDX) з точністю float

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if two n-D float precision bounding boxes (GIDX) intersect each other.
uk: Повертає <varname>TRUE</varname>, якщо дві n-вимірні обмежувальні рамки (GIDX) з плаваючою точністю перетинаються між собою.

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)
uk: Оператор <varname>&amp;&amp;&amp;</varname> повертає <varname>TRUE</varname>, якщо дві n-вимірні обмежувальні рамки A і B перетинаються, використовуючи точність float. Це означає, що якщо A (або B) є (подвійної точності) box3d, вона буде внутрішньо перетворена в обмежувальну рамку 3D з точністю float (GIDX)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is to the left of B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A перекриває або знаходиться ліворуч від обмежувальної рамки B.

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.
uk: Оператор <varname>&amp;&lt;</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A перекриває або знаходиться ліворуч від обмежувальної рамки геометрії B, або, точніше, перекриває або НЕ знаходиться праворуч від обмежувальної рамки геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is below B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A перекриває або знаходиться нижче обмежувальної рамки B.

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.
uk: Оператор <varname>&amp;&lt;|</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A перекриває або знаходиться нижче обмежувальної рамки геометрії B, або, точніше, перекриває або НЕ знаходиться вище обмежувальної рамки геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A' bounding box overlaps or is to the right of B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A перекриває або знаходиться праворуч від обмежувальної рамки B.

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.
uk: Оператор <varname>&amp;&gt;</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A перекриває або знаходиться праворуч від обмежувальної рамки геометрії B, або, точніше, перекриває або НЕ знаходиться ліворуч від обмежувальної рамки геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly to the left of B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A знаходиться строго ліворуч від B.

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.
uk: Оператор <varname>&lt;&lt;</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A знаходиться строго ліворуч від обмежувальної рамки геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly below B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A знаходиться строго нижче B.

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.
uk: Оператор <varname>&lt;&lt;|</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A знаходиться строго нижче обмежувальної рамки геометрії B.

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.
uk: Повертає <varname>TRUE</varname>, якщо координати та порядок координат геометрії/географії A збігаються з координатами та порядком координат геометрії/географії B.

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).
uk: Оператор <varname>&#61;</varname> повертає <varname>TRUE</varname>, якщо координати та порядок координат геометрії/географії A збігаються з координатами та порядком координат геометрії/географії B. PostgreSQL використовує оператори =, &lt; та &gt;, визначені для геометрій, для виконання внутрішнього впорядкування та порівняння геометрій (тобто в операторах GROUP BY або ORDER BY).

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"/>
uk: Цей оператор вважає рівними лише геометрію/географію, які є абсолютно однаковими в усіх відношеннях, мають однакові координати в однаковому порядку. Для "просторової рівності", яка ігнорує такі речі, як порядок координат, і може виявляти об'єкти, що займають однакову просторову площу, але мають різне представлення, використовуйте <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;.
uk: Цей операнд НЕ використовуватиме жодних індексів, які можуть бути доступні для геометрій. Для перевірки точної рівності за допомогою індексу поєднайте &#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.
uk: Змінено: 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.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A знаходиться строго праворуч від B.

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.
uk: Оператор <varname>&gt;&gt;</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A знаходиться строго праворуч від обмежувальної рамки геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contained by B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A міститься в обмежувальній рамці B.

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.
uk: Оператор <varname>@</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A повністю міститься в обмежувальній рамці геометрії B.

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).
uk: Повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка геометрії міститься в 2D обмежувальній рамці з плаваючою точністю (BOX2DF).

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)
uk: Оператор <varname>@</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка геометрії A міститься в 2D обмежувальній рамці B, використовуючи точність float. Це означає, що якщо B є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (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.
uk: Повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка з плаваючою точністю (BOX2DF) міститься в 2D обмежувальній рамці геометрії.

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)
uk: Оператор <varname>@</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка A міститься в 2D обмежувальній рамці геометрії B, використовуючи точність float. Це означає, що якщо B є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (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.
uk: Повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка з плаваючою точністю (BOX2DF) міститься в іншій 2D обмежувальній рамці з плаваючою точністю.

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)
uk: Оператор <varname>@</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка A міститься в 2D обмежувальній рамці B, використовуючи точність float. Це означає, що якщо A (або B) є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is above B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A перекриває або знаходиться над обмежувальною рамкою B.

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.
uk: Оператор <varname>|&amp;&gt;</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A перекриває або знаходиться над обмежувальною рамкою геометрії B, або, точніше, перекриває або НЕ знаходиться нижче обмежувальної рамки геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly above B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A знаходиться строго над обмежувальною рамкою B.

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.
uk: Оператор <varname>|&gt;&gt;</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A знаходиться строго над обмежувальною рамкою геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box contains B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A містить B.

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.
uk: Оператор <varname>~</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії A повністю містить обмежувальну рамку геометрії B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).
uk: Повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка геометрії містить 2D обмежувальну рамку з плаваючою точністю (GIDX).

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)
uk: Оператор <varname>~</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка геометрії A містить 2D обмежувальну рамку B, використовуючи точність float. Це означає, що якщо B є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка з плаваючою точністю 2D (BOX2DF) містить обмежувальну рамку 2D геометрії.

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)
uk: Оператор <varname>~</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка A містить обмежувальну рамку геометрії B, використовуючи точність float. Це означає, що якщо A є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (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).
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка з точністю до 2D float (BOX2DF) містить іншу обмежувальну рамку з точністю до 2D float (BOX2DF).

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)
uk: Оператор <varname>~</varname> повертає <varname>TRUE</varname>, якщо 2D обмежувальна рамка A містить 2D обмежувальну рамку B, використовуючи точність float. Це означає, що якщо A є (подвійної точності) box2d, вона буде внутрішньо перетворена в 2D обмежувальну рамку з точністю float (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is the same as B's.
uk: Повертає <varname>TRUE</varname>, якщо обмежувальна рамка A збігається з обмежувальною рамкою B.

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.
uk: Оператор <varname>~=</varname> повертає <varname>TRUE</varname>, якщо обмежувальна рамка геометрії/географії A збігається з обмежувальною рамкою геометрії/географії B.

note: Tag: para
en: Availability: 1.5.0 changed behavior
uk: Доступність: 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"/>.
uk: У PostGIS 1.5 поведінка цього оператора змінилася: замість перевірки фактичної геометричної рівності тепер перевіряється лише рівність обмежувальної рамки. Щоб ускладнити справу, поведінка оператора також залежить від того, чи було оновлення жорстким чи м'яким. Щоб дізнатися, яку поведінку має ваша база даних, виконайте запит, наведений нижче. Щоб перевірити справжню рівність, використовуйте <xref linkend="ST_OrderingEquals"/>або <xref linkend="ST_Equals"/>.

note: Tag: title
en: Distance Operators
uk: Оператори відстані

note: Tag: refpurpose
en: Returns the 2D distance between A and B.
uk: Повертає 2D відстань між A і B.

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.
uk: Оператор <varname>&lt;-&gt;</varname> повертає двовимірну відстань між двома геометріями. Використовується в розділі "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.
uk: Цей операнд використовує 2D-індекси 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;POINT(1011102 450541)'::geometry instead of a.geom
uk: Індекс спрацьовує тільки в тому випадку, якщо одна з геометрій є константою (не знаходиться в підзапиті/cte). Наприклад, “SRID=3005;POINT(1011102 450541)”::geometry замість a.geom

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.
uk: Детальний приклад див. у <link xlink:href="https://postgis.net/workshops/postgis-intro/knn.html">семінарі PostGIS: Пошук найближчих сусідів</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.
uk: Покращено: 2.2.0 — Поведінка True KNN ("K найближчих сусідів") для геометрії та географії для PostgreSQL 9.5+. Примітка щодо географії: 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.
uk: Змінено: 2.2.0 — Для користувачів PostgreSQL 9.5 старий гібридний синтаксис може працювати повільніше, тому вам слід позбутися цього хаку, якщо ви виконуєте свій код тільки на PostGIS 2.2+ 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+
uk: Доступність: 2.0.0 — Weak KNN надає найближчих сусідів на основі геометричних відстаней до центроїдів замість реальних відстаней. Точні результати для точок, неточні для всіх інших типів. Доступно для PostgreSQL 9.1+

note: Tag: para
en: Then the KNN raw answer:
uk: Потім необроблена відповідь KNN:

note: Tag: para
en: If you run "EXPLAIN ANALYZE" on the two queries you would see a performance improvement for the second.
uk: Якщо ви виконаєте "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:
uk: Для користувачів, які працюють з PostgreSQL &lt; 9.5, використовуйте гібридний запит, щоб знайти найближчих сусідів. Спочатку виконайте запит CTE з використанням KNN з індексом, а потім точний запит, щоб отримати правильний порядок:

note: Tag: refpurpose
en: Returns the distance between A and B trajectories at their closest point of approach.
uk: Повертає відстань між траєкторіями 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).
uk: Оператор <varname>|=|</varname> повертає 3D відстань між двома траєкторіями (див. <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.
uk: Цей операнд використовує індекси ND 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
uk: Індекс спрацьовує тільки в тому випадку, якщо одна з геометрій є константою (не в підзапиті/cte). Наприклад, “SRID=3005;LINESTRINGM(0 0 0,0 0 1)”::geometry замість a.geom.

note: Tag: para
en: Availability: 2.2.0. Index-supported only available for PostgreSQL 9.5+
uk: Доступність: 2.2.0. Підтримка індексу доступна тільки для PostgreSQL 9.5+

note: Tag: refpurpose
en: Returns the 2D distance between A and B bounding boxes.
uk: Повертає 2D відстань між обмежувальними рамками A і B.

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.
uk: Оператор <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.
uk: Цей операнд використовує всі індекси, які можуть бути доступні для геометрій. Він відрізняється від інших операторів, які використовують просторові індекси, тим, що просторовий індекс використовується тільки тоді, коли оператор знаходиться в розділі 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;.
uk: Індекс спрацьовує тільки в тому випадку, якщо одна з геометрій є константою, наприклад ORDER BY (ST_GeomFromText(“POINT(1 2)”) &lt;#&gt; geom) замість g1.geom &lt;#&gt;.

note: Tag: para
en: Availability: 2.0.0 -- KNN only available for PostgreSQL 9.1+
uk: Доступність: 2.0.0 — KNN доступний тільки для PostgreSQL 9.1+

note: Tag: refpurpose
en: Returns the n-D distance between the A and B geometries or bounding boxes
uk: Повертає n-вимірну відстань між геометріями A і B або обмежувальними рамками

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.
uk: Оператор <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.
uk: Цей операнд використовує індекси n-D GiST, які можуть бути доступні для геометрій. Він відрізняється від інших операторів, що використовують просторові індекси, тим, що просторовий індекс використовується тільки тоді, коли оператор знаходиться в розділі ORDER BY.

note: Tag: para
en: Availability: 2.2.0 -- KNN only available for PostgreSQL 9.1+
uk: Доступність: 2.2.0 — KNN доступний тільки для PostgreSQL 9.1+

note: Tag: title
en: Geometry Output
uk: Вивід геометрії

note: Tag: para
en: These functions convert geometry objects into various textual or binary formats.
uk: Ці функції перетворюють геометричні об'єкти в різні текстові або двійкові формати.

note: Tag: refpurpose
en: Return the Well-Known Text (WKT) representation of the geometry with SRID meta data.
uk: Повернути представлення геометрії у вигляді добре відомого тексту (WKT) з метаданими SRID.

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).
uk: Повертає добре відоме текстове представлення геометрії з префіксом SRID. Опціональний аргумент <parameter>maxdecimaldigits</parameter> може використовуватися для зменшення максимальної кількості десяткових цифр після плаваючої коми, що використовуються у вихідних даних (за замовчуванням — 15).

note: Tag: para
en: To perform the inverse conversion of EWKT representation to PostGIS geometry use <xref linkend="ST_GeomFromEWKT"/>.
uk: Для виконання зворотного перетворення представлення 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.
uk: Використання параметра <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"/>.
uk: Специфікація 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.
uk: Формат WKT не зберігає точність, тому щоб запобігти обрізанню плаваючої точки, для передачі використовуйте формат <xref linkend="ST_AsBinary"/>або <xref linkend="ST_AsEWKB"/>.

note: Tag: para
en: Enhanced: 3.1.0 support for optional precision parameter.
uk: Покращено: 3.1.0 підтримка опціонального параметра точності.

note: Tag: para
en: Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and TIN was introduced.
uk: Покращено: 2.0.0 додано підтримку географії, багатогранних поверхонь, трикутників і TIN.

note: Tag: refpurpose
en: Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.
uk: Повернути представлення геометрії/географії у вигляді добре відомого тексту (WKT) без метаданих SRID.

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).
uk: Повертає представлення геометрії/географії у форматі OGC <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"/>.
uk: Для виконання зворотного перетворення представлення WKT в геометрію 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"/>
uk: Стандартне представлення 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>).
uk: Текстове представлення чисел у 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.
uk: Доступність: 1.5 — додано підтримку географії.

note: Tag: para
en: Enhanced: 2.5 - optional parameter precision introduced.
uk: Покращено: 2.5 — додано опційний параметр точності.

note: Tag: para
en: Full precision output is the default.
uk: Повна точність виводу є стандартною настройкою.

note: Tag: para
en: The <parameter>maxdecimaldigits</parameter> argument can be used to limit output precision.
uk: Аргумент <parameter>maxdecimaldigits</parameter> можна використовувати для обмеження точності виводу.

note: Tag: refpurpose
en: Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
uk: Повернути представлення геометрії/географії у форматі OGC/ISO Well-Known Binary (WKB) без метаданих SRID.

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 'NDR' for little-endian; or 'XDR' for big-endian. Supplying unknown arguments will result in little-endian output.
uk: Повертає представлення геометрії у форматі OGC/ISO <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB). Перший варіант функції за замовчуванням використовує кодування, що відповідає ендіану сервера. Другий варіант функції приймає текстовий аргумент, що визначає кодування ендіана: “NDR” для little-endian або “XDR” для big-endian. Введення невідомих аргументів призведе до виведення little-endian.

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.
uk: Формат WKB корисний для читання геометричних даних з бази даних та збереження повної числової точності. Це дозволяє уникнути округлення точності, яке може відбуватися у текстових форматах, таких як WKT.

note: Tag: para
en: To perform the inverse conversion of WKB to PostGIS geometry use <xref linkend="ST_GeomFromWKB"/>.
uk: Для виконання зворотного перетворення WKB в геометрію 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"/>
uk: Формат OGC/ISO WKB не включає SRID. Щоб отримати формат EWKB, який включає SRID, використовуйте <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.
uk: Стандартна поведінка в PostgreSQL 9.0 була змінена на виведення bytea в шістнадцятковому кодуванні. Якщо ваші графічні інструменти вимагають старої поведінки, то встановіть SET bytea_output=“escape” у вашій базі даних.

note: Tag: para
en: Enhanced: 2.0.0 support for higher coordinate dimensions was introduced.
uk: Покращено: 2.0.0 додано підтримку вищих розмірностей координат.

note: Tag: para
en: Enhanced: 2.0.0 support for specifying endian with geography was introduced.
uk: Покращено: 2.0.0 додано підтримку вказання ендіанності для географічних даних.

note: Tag: para
en: Availability: 1.5.0 geography support was introduced.
uk: Доступність: 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>.
uk: Змінено: 2.0.0 Вхідні дані для цієї функції не можуть бути невідомими — вони повинні бути геометрією. Такі конструкції, як <code>ST_AsBinary(“POINT(1 2)”)</code>, більше не є дійсними, і ви отримаєте помилку <code>n st_asbinary(unknown) is not unique</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.
uk: Повернути розширене добре відоме двійкове (EWKB) представлення геометрії з метаданими SRID.

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 'NDR' for little-endian; or 'XDR' for big-endian. Supplying unknown arguments will result in little-endian output.
uk: Повертає представлення геометрії у форматі <link linkend="EWKB_EWKT">Extended Well-Known Binary</link> (EWKB) з метаданими SRID. Перший варіант функції за замовчуванням використовує кодування, що відповідає порядку байтів на сервері. Другий варіант функції приймає текстовий аргумент, що визначає кодування ендіана: “NDR” для little-endian або “XDR” для big-endian. Введення невідомих аргументів призведе до виведення little-endian.

note: Tag: para
en: To perform the inverse conversion of EWKB to PostGIS geometry use <xref linkend="ST_GeomFromEWKB"/>.
uk: Для виконання зворотного перетворення EWKB в геометрію 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.
uk: Щоб отримати формат 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.
uk: Повертає геометрію у форматі HEXEWKB (у вигляді тексту) з використанням кодування little-endian (NDR) або big-endian (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.
uk: Повертає геометрію у форматі HEXEWKB (у вигляді тексту) з використанням кодування little-endian (NDR) або big-endian (XDR). Якщо кодування не вказано, використовується NDR.

note: Tag: refpurpose
en: Returns an Encoded Polyline from a LineString geometry.
uk: Повертає закодовану полілінію з геометрії LineString.

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.
uk: Повертає геометрію у вигляді закодованої полілінії. Цей формат використовується Google Maps з точністю = 5 та Open Source Routing Machine з точністю = 5 і 6.

note: Tag: para
en: Basic
uk: Базовий

note: Tag: para
en: Use in conjunction with geography linestring and geography segmentize, and put on google maps
uk: Використовуйте разом із географічними лініями та географічною сегментацією, а також розмістіть на картах Google

note: Tag: para
en: javascript will look something like this where $ variable you replace with query result
uk: javascript буде виглядати приблизно так, де змінну $ ви замінюєте результатом запиту

note: Tag: refpurpose
en: Return a FlatGeobuf representation of a set of rows.
uk: Повернути представлення 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.
uk: Повертає представлення FlatGeobuf (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>) набору рядків, що відповідають FeatureCollection. ПРИМІТКА: PostgreSQL bytea не може перевищувати 1 ГБ.

note: Tag: para
en: <varname>row</varname> row data with at least a geometry column.
uk: <varname>row</varname> дані рядка, що містять принаймні стовпець геометрії.

note: Tag: para
en: <varname>index</varname> toggle spatial index creation. Default is false.
uk: <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.
uk: <varname>geom_name</varname> — це назва стовпця геометрії в даних рядка. Якщо NULL, за замовчуванням буде використано перший знайдений стовпець геометрії.

note: Tag: refpurpose
en: Return a Geobuf representation of a set of rows.
uk: Повернути представлення 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.
uk: Повертає представлення Geobuf (<link xlink:href="https://github.com/mapbox/geobuf">https://github.com/mapbox/geobuf</link>) набору рядків, що відповідають FeatureCollection. Кожна вхідна геометрія аналізується для визначення максимальної точності для оптимального зберігання. Зверніть увагу, що Geobuf у його поточній формі не може бути переданий потоком, тому повний вихід буде зібраний у пам'яті.

note: Tag: refpurpose
en: Return a geometry or feature in GeoJSON format.
uk: Повернути геометрію або об'єкт у форматі GeoJSON.

note: Tag: para
en: Returns a geometry as a GeoJSON "geometry" object, or a row as a GeoJSON "feature" object.
uk: Повертає геометрію як об'єкт 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).
uk: Отримані геометричні та об'єктні представлення GeoJSON відповідають <link xlink:href="https://tools.ietf.org/html/rfc7946">специфікаціям GeoJSON 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 за замовчуванням буде додано короткий ідентифікатор CRS SRID. Підтримуються як 2D, так і 3D геометрії. 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.
uk: Параметр <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.
uk: Аргумент <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:
uk: Аргумент <varname>options</varname> можна використовувати для додавання BBOX або CRS у вихідні дані GeoJSON:

note: Tag: para
en: 0: means no option
uk: 0: означає відсутність опції

note: Tag: para
en: 2: GeoJSON Short CRS (e.g EPSG:4326)
uk: 2: GeoJSON коротка CRS (наприклад, EPSG:4326)

note: Tag: para
en: 4: GeoJSON Long CRS (e.g urn:ogc:def:crs:EPSG::4326)
uk: 4: GeoJSON Long CRS (наприклад, urn:ogc:def:crs:EPSG::4326)

note: Tag: para
en: 8: GeoJSON Short CRS if not EPSG:4326 (default)
uk: 8: GeoJSON Короткий CRS, якщо не EPSG:4326 (за замовчуванням)

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.
uk: Параметр <varname>id_column</varname> використовується для встановлення елемента "id" повернутих об'єктів GeoJSON. Відповідно до 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>.
uk: Специфікація GeoJSON визначає, що полігони орієнтуються за правилом правої руки, і деякі клієнти вимагають такої орієнтації. Це можна забезпечити за допомогою <xref linkend="ST_ForcePolygonCCW"/>. Специфікація також вимагає, щоб геометрія була в системі координат WGS84 (SRID = 4326). За необхідності геометрію можна спроектувати в WGS84 за допомогою <xref linkend="ST_Transform"/>: <code>ST_Transform( geom, 4326 )</code>.

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:
uk: GeoJSON можна протестувати та переглянути онлайн за адресами <link xlink:href="http://geojson.io/">geojson.io</link> та <link xlink:href="http://geojson.io/">geojsonlint.com</link>. Він широко підтримується веб-картографічними фреймворками:

note: Tag: link
en: OpenLayers GeoJSON Example
uk: Приклад OpenLayers GeoJSON

note: Tag: link
en: Leaflet GeoJSON Example
uk: Приклад GeoJSON для листівки

note: Tag: link
en: Mapbox GL GeoJSON Example
uk: Приклад Mapbox GL GeoJSON

note: Tag: para
en: Availability: 1.3.4
uk: Доступність: 1.3.4

note: Tag: para
en: Changed: 2.0.0 support default args and named args.
uk: Змінено: 2.0.0 підтримка аргументів за замовчуванням та іменованих аргументів.

note: Tag: para
en: Changed: 3.0.0 support records as input
uk: Змінено: 3.0.0 підтримка записів як вхідних даних

note: Tag: para
en: Changed: 3.0.0 output SRID if not EPSG:4326.
uk: Змінено: 3.0.0 виведення SRID, якщо не EPSG:4326.

note: Tag: para
en: Changed: 3.5.0 allow specifying the column containing the feature id
uk: Змінено: 3.5.0 Дозволено вказувати стовпець, що містить feature id

note: Tag: para
en: Generate a FeatureCollection:
uk: Створити колекцію об'єктів:

note: Tag: para
en: Generate a Feature:
uk: Створити Feature:

note: Tag: para
en: Don't forget to transform your data to WGS84 longitude, latitude to conform with the GeoJSON specification:
uk: Не забудьте перетворити дані в довготу WGS84, широту, щоб вони відповідали специфікації GeoJSON:

note: Tag: para
en: 3D geometries are supported:
uk: Підтримуються 3D-геометрії:

note: Tag: para
en: Options argument can be used to add BBOX and CRS in GeoJSON output:
uk: Аргумент Options можна використовувати для додавання BBOX і CRS у вихідні дані GeoJSON:

note: Tag: refpurpose
en: Return the geometry as a GML version 2 or 3 element.
uk: Повернути геометрію як елемент 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).
uk: Повернути геометрію як елемент мови географічної розмітки (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
uk: GML 2 відноситься до версії 2.1.2, GML 3 – до версії 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:
uk: Аргумент "options" є бітовим полем. Він може використовуватися для визначення типу виводу CRS у виводі GML та для оголошення даних як lat/lon:

note: Tag: para
en: 0: GML Short CRS (e.g EPSG:4326), default value
uk: 0: Коротка CRS GML (наприклад, EPSG:4326), значення за замовчуванням

note: Tag: para
en: 1: GML Long CRS (e.g urn:ogc:def:crs:EPSG::4326)
uk: 1: GML Long CRS (наприклад, urn:ogc:def:crs:EPSG::4326)

note: Tag: para
en: 2: For GML 3 only, remove srsDimension attribute from output.
uk: 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.
uk: 4: Тільки для GML 3 використовуйте тег &lt;LineString&gt; замість &lt;Curve&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.
uk: 16: Заявити, що дані є широтою/довготою (наприклад, srid=4326). За замовчуванням вважається, що дані є планарними. Ця опція корисна тільки для виводу GML 3.1.1, пов'язаного з порядком осей. Тому, якщо ви її встановите, координати будуть поміняні місцями, і порядок буде широта-довгота замість довгота-широта, як у базі даних.

note: Tag: para
en: 32: Output the box of the geometry (envelope).
uk: 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
uk: Аргумент "namespace prefix" може використовуватися для вказання власного префікса простору імен або відсутності префікса (якщо поле порожнє). Якщо префікс "gml" нульовий або пропущений, використовується префікс "gml"

note: Tag: para
en: Availability: 1.3.2
uk: Доступність: 1.3.2

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.
uk: Покращено: додано підтримку префікса 2.0.0. Додано опцію 4 для GML3, що дозволяє використовувати тег LineString замість Curve для ліній. Додано підтримку GML3 для багатогранних поверхонь і TINS. Додано опцію 32 для виведення прямокутника.

note: Tag: para
en: Changed: 2.0.0 use default named args
uk: Змінено: 2.0.0 використання аргументів із стандартними іменами

note: Tag: para
en: Enhanced: 2.1.0 id support was introduced, for GML 3.
uk: Покращено: 2.1.0 Додано підтримку ідентифікаторів для GML 3.

note: Tag: para
en: Only version 3+ of ST_AsGML supports Polyhedral Surfaces and TINS.
uk: Тільки версія 3+ ST_AsGML підтримує багатогранні поверхні та TINS.

note: Tag: title
en: Examples: Version 2
uk: Приклади: Версія 2

note: Tag: title
en: Examples: Version 3
uk: Приклади: Версія 3

note: Tag: refpurpose
en: Return the geometry as a KML element.
uk: Повернути геометрію як елемент 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.
uk: Повернути геометрію як елемент мови розмітки Keyhole (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.
uk: Потрібно, щоб 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
uk: Доступність: 1.2.2 — пізніші варіанти, що містять параметр версії, з'явилися в 1.3.2

note: Tag: para
en: Enhanced: 2.0.0 - Add prefix namespace, use default and named args
uk: Покращено: 2.0.0 - Додано префікс простору імен, використання аргументів за замовчуванням та іменованих аргументів

note: Tag: para
en: Changed: 3.0.0 - Removed the "versioned" variant signature
uk: Змінено: 3.0.0 - Вилучено підпис варіанту "versioned"

note: Tag: para
en: AsKML output will not work with geometries that do not have an SRID
uk: Вихідні дані AsKML не працюватимуть з геометріями, які не мають SRID

note: Tag: refpurpose
en: Return the Degrees, Minutes, Seconds representation of the given point.
uk: Повернути представлення градусів, хвилин, секунд заданої точки.

note: Tag: para
en: Returns the Degrees, Minutes, Seconds representation of the point.
uk: Повертає представлення точки у градусах, хвилинах і секундах.

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).
uk: Передбачається, що точка знаходиться в проекції широти/довготи. Координати 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").
uk: Параметр text є рядком формату, що містить формат для отриманого тексту, подібний до рядка формату дати. Допустимі символи: "D" для градусів, "M" для хвилин, "S" для секунд і "C" для основних напрямків (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.
uk: "M", "S" та "C" є необов'язковими. Якщо "C" опущено, градуси позначаються знаком "-", якщо вони південні або західні. Якщо "S" опущено, хвилини відображаються у вигляді десяткових чисел із точністю до заданої кількості цифр. Якщо "M" також опущено, градуси відображаються у вигляді десяткових чисел із точністю до заданої кількості цифр.

note: Tag: para
en: If the format string is omitted (or zero-length) a default format will be used.
uk: Якщо рядок формату пропущено (або має нульову довжину), буде використано формат за замовчуванням.

note: Tag: para
en: Default format.
uk: Формат за замовчуванням.

note: Tag: para
en: Providing a format (same as the default).
uk: Надання формату (такого самого, як за замовчуванням).

note: Tag: para
en: Characters other than D, M, S, C and . are just passed through.
uk: Символи, крім D, M, S, C і ., просто пропускаються.

note: Tag: para
en: Signed degrees instead of cardinal directions.
uk: Підписані ступені замість основних напрямків.

note: Tag: para
en: Decimal degrees.
uk: Десятичні градуси.

note: Tag: para
en: Excessively large values are normalized.
uk: Надмірно великі значення нормалізуються.

note: Tag: refpurpose
en: Returns geometry as a MARC21/XML record with a geographic datafield (034).
uk: Повертає геометрію у вигляді запису MARC21/XML із полем географічних даних (034).

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:
uk: Ця функція повертає запис MARC21/XML з <link xlink:href="https://www.loc.gov/marc/bibliographic/bd034.html">Кодованими картографічними математичними даними</link>, що представляють обмежувальну рамку заданої геометрії. Параметр <varname>format</varname> дозволяє кодувати координати в підполях <varname>$d</varname>,<varname>$e</varname>,<varname>$f</varname> та <varname>$g</varname> у всіх форматах, що підтримуються стандартом MARC21/XML. Допустимі формати:

note: Tag: para
en: cardinal direction, degrees, minutes and seconds (default): <varname>hdddmmss</varname>
uk: основний напрямок, градуси, хвилини та секунди (за замовчуванням): <varname>hdddmmss</varname>

note: Tag: para
en: decimal degrees with cardinal direction: <varname>hddd.dddddd</varname>
uk: десятиградусні градуси з основним напрямком: <varname>hddd.dddddd</varname>

note: Tag: para
en: decimal degrees without cardinal direction: <varname>ddd.dddddd</varname>
uk: десятиградусні градуси без вказівки сторони світу: <varname>ddd.dddddd</varname>

note: Tag: para
en: decimal minutes with cardinal direction: <varname>hdddmm.mmmm</varname>
uk: десятикратні хвилини з основним напрямком: <varname>hdddmm.mmmm</varname>

note: Tag: para
en: decimal minutes without cardinal direction: <varname>dddmm.mmmm</varname>
uk: десятинні хвилини без вказівки напрямку: <varname>dddmm.mmmm</varname>

note: Tag: para
en: decimal seconds with cardinal direction: <varname>hdddmmss.sss</varname>
uk: десятинні секунди з основним напрямком: <varname>hdddmmss.sss</varname>

note: Tag: para
en: The decimal sign may be also a comma, e.g. <varname>hdddmm,mmmm</varname>.
uk: Знак десяткового числа може бути також комою, наприклад <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.
uk: Точність десяткових форматів може бути обмежена кількістю символів після десяткового знака, наприклад <varname>hdddmm.mm</varname> для десяткових хвилин з точністю до двох десяткових знаків.

note: Tag: para
en: This function ignores the Z and M dimensions.
uk: Ця функція ігнорує розміри 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).
uk: Ця функція не підтримує геометрії, що не є lon/lat, оскільки вони не підтримуються стандартом MARC21/XML (Coded Cartographic Mathematical Data).

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.
uk: Стандарт MARC21/XML не передбачає жодних засобів для анотування просторової системи координат для кодованих картографічних математичних даних, що означає, що ця інформація буде втрачена після перетворення у формат MARC21/XML.

note: Tag: para
en: Converting a <varname>POINT</varname> to MARC21/XML formatted as hdddmmss (default)
uk: Перетворення <varname>POINT</varname> у формат MARC21/XML у вигляді hdddmmss (за замовчуванням)

note: Tag: para
en: Converting a <varname>POLYGON</varname> to MARC21/XML formatted in decimal degrees
uk: Перетворення <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.
uk: Перетворення <varname>GEOMETRYCOLLECTION</varname> у формат MARC21/XML з десятковими хвилинами. Порядок геометрій у вихідних даних MARC21/XML відповідає їхньому порядку в колекції.

note: Tag: refpurpose
en: Transforms a geometry into the coordinate space of a MVT tile.
uk: Перетворює геометрію в координатну систему плитки 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).
uk: Перетворює геометрію в координатну систему плитки 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.
uk: Функція намагається зберегти правильність геометрії та виправити її, якщо це необхідно. Це може призвести до скорочення геометрії результату до нижчого виміру.

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"/>.
uk: Необхідно вказати прямокутні межі плитки в просторі координат цільової карти, щоб можна було трансформувати геометрію та обрізати її за необхідності. Межі можна створити за допомогою <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"/>.
uk: Ця функція використовується для перетворення геометрії в координатну систему плиток, необхідну для <xref linkend="ST_AsMVT"/>.

note: Tag: para
en: <varname>geom</varname> is the geometry to transform, in the coordinate system of the target map.
uk: <varname>geom</varname> — геометрія, яку потрібно трансформувати в системі координат цільової карти.

note: Tag: para
en: <varname>bounds</varname> is the rectangular bounds of the tile in map coordinate space, with no buffer.
uk: <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.
uk: <varname>extent</varname> — розмір площі плитки в просторі координат плитки, як визначено в <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">специфікації MVT</link>. За замовчуванням — 4096.

note: Tag: para
en: <varname>buffer</varname> is the buffer size in tile coordinate space for geometry clippig. Defaults to 256.
uk: <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.
uk: <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.
uk: Починаючи з версії 3.0, під час конфігурації можна вибрати Wagyu для обрізання та перевірки полігонів MVT. Ця бібліотека працює швидше та дає більш правильні результати, ніж стандартна GEOS, але може пропускати невеликі полігони.

note: Tag: para
en: Canonical example for a Web Mercator tile using a computed tile bounds to query and clip geometry. This assumes the data.geom column has srid of 4326.
uk: Канонічний приклад для плитки Web Mercator з використанням обчислених меж плитки для запиту та обрізки геометрії. Припускається, що стовпець data.geom має srid 4326.

note: Tag: refpurpose
en: Aggregate function returning a MVT representation of a set of rows.
uk: Агрегатна функція, що повертає 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.
uk: Агрегатна функція, яка повертає двійкове <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> представлення набору рядків, що відповідають шару плиток. Рядки повинні містити стовпець геометрії, який буде закодований як геометрія об'єкта. Геометрія повинна бути в просторі координат плитки та відповідати <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">специфікації MVT</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.
uk: Формат <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> може зберігати об'єкти з різними наборами атрибутів. Щоб скористатися цією можливістю, надайте стовпець JSONB у даних рядка, що містить об'єкти Json одного рівня. Ключі та значення в значеннях 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>.
uk: Плитки з декількома шарами можна створити, об'єднавши кілька викликів цієї функції за допомогою <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.
uk: Не викликайте з <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".
uk: <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.
uk: <varname>extent</varname> — це розмір плитки в просторі екрана, як визначено в специфікації. За замовчуванням — 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.
uk: <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.
uk: <varname>feature_id_name</varname> — це назва стовпця Feature ID у даних рядка. Якщо значення NULL або від’ємне, Feature ID не встановлюється. Перший стовпець, що відповідає назві та дійсному типу (smallint, integer, bigint), буде використано як Feature ID, а всі наступні стовпці будуть додано як властивості. Властивості JSON не підтримуються.

note: Tag: para
en: Enhanced: 3.0 - added support for Feature ID.
uk: Покращено: 3.0 — додано підтримку ідентифікатора функції.

note: Tag: para
en: Enhanced: 2.5.0 - added support parallel query.
uk: Покращено: 2.5.0 — додано підтримку паралельних запитів.

note: Tag: refpurpose
en: Returns SVG path data for a geometry.
uk: Повертає дані 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 (";").
uk: Повернути геометрію як дані шляху Scalar Vector Graphics (SVG). Використовуйте 1 як другий аргумент, щоб дані шляху були реалізовані у вигляді відносних переміщень, за замовчуванням (або 0) використовуються абсолютні переміщення. Третій аргумент може бути використаний для зменшення максимальної кількості десяткових цифр, що використовуються у вихідних даних (за замовчуванням 15). Точкові геометрії будуть відображатися як cx/cy, коли аргумент “rel” дорівнює 0, x/y, коли “rel” дорівнює 1. Багатоточкові геометрії розділяються комами (","), геометрії GeometryCollection розділяються крапками з комою (";").

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.
uk: Для роботи з графікою PostGIS SVG, ознайомтеся з бібліотекою <link xlink:href="https://github.com/dr-jts/pg_svg">pg_svg</link>, яка надає функції plpgsql для роботи з результатами ST_AsSVG.

note: Tag: para
en: Enhanced: 3.4.0 to support all curve types
uk: Покращено: 3.4.0 для підтримки всіх типів кривих

note: Tag: para
en: Changed: 2.0.0 to use default args and support named args
uk: Змінено: 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>
uk: Доступність: 1.2.2. Доступність: 1.4.0 Змінено в PostGIS 1.4.0, щоб включити команду L в абсолютний шлях для відповідності <link xlink:href="http://www.w3.org/TR/SVG/paths.html#PathDataBNF">http://www.w3.org/TR/SVG/paths.html#PathDataBNF</link>

note: Tag: refpurpose
en: Returns the geometry as TWKB, aka "Tiny Well-Known Binary"
uk: Повертає геометрію у вигляді 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.
uk: Повертає геометрію у форматі TWKB (Tiny Well-Known Binary). TWKB — це <link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">стислий двійковий формат</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.
uk: Параметри десяткових цифр контролюють точність збереження даних у вихідних даних. За замовчуванням значення округлюються до найближчої одиниці перед кодуванням. Якщо потрібно передати більш точні дані, збільште це число. Наприклад, значення 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).
uk: Параметри розмірів та обмежувальних рамок визначають, чи буде у вихідні дані включена додаткова інформація про довжину кодованого об'єкта та межі об'єкта. За замовчуванням вони не включені. Не вмикайте їх, якщо ваше програмне забезпечення не використовує їх, оскільки вони лише займають місце (а економія місця є метою 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.
uk: Форма функції з вхідним масивом використовується для перетворення набору геометрій та унікальних ідентифікаторів у набір TWKB, який зберігає ідентифікатори. Це корисно для клієнтів, які хочуть розпакувати набір, а потім отримати доступ до додаткової інформації про об'єкти всередині. Масиви можна створити за допомогою функції <link xlink:href="https://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>.
uk: Специфікація формату доступна в Інтернеті за адресою <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.
uk: Покращено: 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.
uk: Щоб створити агрегований об'єкт TWKB, що містить ідентифікатори, спочатку агрегуйте потрібні геометрії та об'єкти за допомогою функції "array_agg()", а потім викличте відповідну функцію TWKB.

note: Tag: refpurpose
en: Returns a Geometry in X3D xml node element format: ISO-IEC-19776-1.2-X3DEncodings-XML
uk: Повертає геометрію у форматі елемента вузла X3D xml: 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.
uk: Повертає геометрію у вигляді елемента вузла у форматі 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.
uk: Існують різні варіанти перетворення геометрії PostGIS у X3D, оскільки типи геометрії X3D не відповідають безпосередньо типам геометрії PostGIS, а деякі новіші типи X3D, які можуть бути кращими відповідниками, ми уникнули, оскільки більшість інструментів візуалізації наразі їх не підтримують. Ось відповідники, на яких ми зупинилися. Якщо у вас є думки щодо цієї ідеї або способів, як ми можемо дозволити користувачам вказувати свої бажані відповідники, будь ласка, повідомте нам про це.

note: Tag: para
en: Below is how we currently map PostGIS 2D/3D types to X3D types
uk: Нижче наведено, як ми наразі відображаємо типи PostGIS 2D/3D у типи 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.
uk: Аргумент "options" є бітовим полем. У PostGIS 2.2+ він використовується для позначення того, чи слід представляти координати за допомогою геопросторового вузла X3D GeoCoordinates, а також чи слід міняти осі x/y. За замовчуванням <code>ST_AsX3D</code> виводить дані у формі бази даних (long,lat або 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).
uk: 0: X/Y у порядку бази даних (наприклад, long/lat = 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.
uk: 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>
uk: 2: Вивести координати в GeoSpatial GeoCoordinates. Ця опція видасть помилку, якщо геометрії не відповідають WGS 84 long lat (srid: 4326). Наразі це єдиний підтримуваний тип GeoCoordinate. <link xlink:href="http://www.web3d.org/documents/specifications/19775-1/V3.2/Part01/components/geodata.html#Specifyingaspatialreference">Дивіться специфікації X3D, що визначають систему просторових координат.</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
uk: Тип PostGIS

note: Tag: entry
en: 2D X3D Type
uk: 2D X3D Тип

note: Tag: entry
en: 3D X3D Type
uk: Тип 3D X3D

note: Tag: entry
en: not yet implemented - will be PolyLine2D
uk: ще не реалізовано - буде PolyLine2D

note: Tag: entry
en: outputs the space delimited coordinates
uk: виводить координати, розділені пробілами

note: Tag: entry
en: Invalid X3D markup
uk: Недійсна розмітка X3D

note: Tag: entry
en: IndexedFaceSet (inner rings currently output as another faceset)
uk: IndexedFaceSet (внутрішні кільця наразі виводяться як інший набір облич)

note: Tag: entry
en: TriangleSet2D (Not Yet Implemented)
uk: TriangleSet2D (ще не реалізовано)

note: Tag: para
en: 2D geometry support not yet complete. Inner rings currently just drawn as separate polygons. We are working on these.
uk: Підтримка 2D-геометрії ще не завершена. Внутрішні кільця наразі малюються як окремі полігони. Ми працюємо над цим.

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>
uk: У 3D-просторі відбувається багато прогресивних змін, особливо в області <link xlink:href="https://www.web3d.org/wiki/index.php/X3D_and_HTML5">інтеграції X3D з 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.
uk: Також є гарний відкритий 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>.
uk: Також зверніть увагу на <link xlink:href="https://git.osgeo.org/gitea/robe/postgis_x3d_viewer">мінімалістичний переглядач PostGIS X3D</link>, який використовує цю функцію, та <link xlink:href="http://www.x3dom.org/">відкритий набір інструментів x3dDom html/js</link>.

note: Tag: para
en: Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML
uk: Доступність: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML

note: Tag: para
en: Enhanced: 2.2.0: Support for GeoCoordinates and axis (x/y, long/lat) flipping. Look at options for details.
uk: Покращено: 2.2.0: Підтримка геокоординат та перевертання осей (x/y, long/lat). Детальніше дивіться в налаштуваннях.

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.
uk: Приклад: Створити повністю функціональний документ X3D - Це створить куб, який можна переглянути в FreeWrl та інших переглядачах X3D.

note: Tag: title
en: PostGIS buildings
uk: 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
uk: Скопіюйте та вставте результат цього запиту в <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
uk: Будівлі, утворені шляхом поділу PostGIS та екструзії

note: Tag: title
en: Example: An Octagon elevated 3 Units and decimal precision of 6
uk: Приклад: Восьмикутник, піднятий на 3 одиниці, з десятковою точністю 6

note: Tag: title
en: Example: TIN
uk: Приклад: TIN

note: Tag: title
en: Example: Closed multilinestring (the boundary of a polygon with holes)
uk: Приклад: Замкнута багатолінійна (межа полігону з отворами)

note: Tag: refpurpose
en: Return a GeoHash representation of the geometry.
uk: Повернути представлення геометрії у форматі 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.
uk: Обчислює <link xlink:href="http://en.wikipedia.org/wiki/Geohash">GeoHash</link> представлення геометрії. GeoHash кодує географічну точку в текстову форму, яку можна сортувати та шукати за префіксом. Коротший GeoHash є менш точним представленням точки. Його можна уявити як прямокутник, що містить точку.

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.
uk: Значення геометрії, що не є точками, з ненульовим розміром також можна відобразити у кодах GeoHash. Точність коду залежить від географічного розміру геометрії.

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.
uk: Якщо <varname>maxchars</varname> не вказано, повертається код GeoHash для найменшої комірки, що містить вхідну геометрію. Точки повертають GeoHash з точністю 20 символів (це приблизно достатньо для повної подвійної точності вхідних даних). Інші геометричні типи можуть повертати GeoHash з меншою точністю, залежно від розміру геометрії. Більші геометрії представлені з меншою точністю, менші — з більшою. Коробка, визначена кодом GeoHash, завжди містить вхідний об'єкт.

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.
uk: Якщо вказано <varname>maxchars</varname>, то повернений код GeoHash має не більше цього значення символів. Він відображається на (можливо) менш точне представлення вхідної геометрії. Для не точкових об'єктів початковою точкою обчислення є центр обмежувальної рамки геометрії.

note: Tag: para
en: ST_GeoHash requires input geometry to be in geographic (lon/lat) coordinates.
uk: ST_GeoHash вимагає, щоб вхідні геометричні дані були в географічних координатах (довгота/широта).

note: Tag: title
en: Overlay Functions
uk: Функції накладання

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.
uk: Ці функції обчислюють результати, що виникають при накладенні двох геометрій. Вони також відомі як булеві операції теорії множин точок. Також надаються деякі пов'язані функції.

note: Tag: refpurpose
en: Computes the portion of a geometry falling within a rectangle.
uk: Обчислює частину геометрії, що потрапляє в прямокутник.

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).
uk: Обрізає геометрію за допомогою 2D-коробки швидким і толерантним, але, можливо, некоректним способом. Топологічно некоректні вхідні геометрії не призводять до виникнення виняткових ситуацій. Не гарантується коректність вихідної геометрії (зокрема, можуть виникнути самоперетини для полігону).

note: Tag: refpurpose
en: Computes a geometry representing the part of geometry A that does not intersect geometry B.
uk: Обчислює геометрію, що представляє частину геометрії A, яка не перетинається з геометрією B.

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.
uk: Повертає геометрію, що представляє частину геометрії A, яка не перетинається з геометрією B. Це еквівалентно <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.
uk: Це єдина функція накладання, де порядок введення має значення. ST_Difference(A, B) завжди повертає частину A.

note: Tag: para
en: Enhanced: 3.1.0 accept a gridSize parameter.
uk: Покращено: 3.1.0 приймає параметр gridSize.

note: Tag: para
en: Requires GEOS &gt;= 3.9.0 to use the gridSize parameter.
uk: Для використання параметра gridSize необхідна версія GEOS &gt;= 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.
uk: &Z_support; Однак результат обчислюється тільки за допомогою XY. Значення результату Z копіюються, усереднюються або інтерполюються.

note: Tag: para
en: The input linestrings
uk: Вхідні ліній

note: Tag: para
en: The difference of the two linestrings
uk: Різниця між двома рядками

note: Tag: para
en: The difference of 2D linestrings.
uk: Різниця між 2D лініями.

note: Tag: para
en: The difference of 3D points.
uk: Різниця між 3D-точками.

note: Tag: refpurpose
en: Computes a geometry representing the shared portion of geometries A and B.
uk: Обчислює геометрію, що представляє спільну частину геометрій 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.
uk: Повертає геометрію, що представляє перетин двох геометрій. Іншими словами, це та частина геометрії 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.
uk: Якщо геометрії не мають спільних точок (тобто є роз'єднаними), то повертається порожня атомарна геометрія відповідного типу.

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.
uk: ST_Intersection у поєднанні з <xref linkend="ST_Intersects"/> корисний для обрізання геометрій, наприклад, у запитах на обмежувальну рамку, буфер або регіон, де потрібна лише частина геометрії, що знаходиться всередині країни або регіону, що цікавить.

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.
uk: &geography_transform; Спочатку визначається найкращий SRID, який відповідає обмежувальній рамці 2 географічних об'єктів (якщо географічні об'єкти знаходяться в межах однієї половини зони UTM, але не в одній і тій же UTM, вибирається одна з них) (віддаючи перевагу UTM або Ламберту Азимутальному рівновеликому (LAEA) північному/південному полюсу, а в найгіршому випадку використовуючи проекцію Меркатора), а потім перетинається в найкращому плоскому просторовому відліку і перетворюється назад в географію WGS84.

note: Tag: para
en: This function will drop the M coordinate values if present.
uk: Ця функція видалить значення координати 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.
uk: <xref linkend="ST_3DIntersection"/> яка виконує правильне 3D перетин для 3D геометрій. Хоча ця функція працює з Z-координатами, вона виконує усереднення Z-координат.

note: Tag: para
en: Enhanced: 3.1.0 accept a gridSize parameter
uk: Покращено: 3.1.0 приймає параметр gridSize

note: Tag: para
en: Requires GEOS &gt;= 3.9.0 to use the gridSize parameter
uk: Для використання параметра gridSize необхідна версія GEOS &gt;= 3.9.0

note: Tag: para
en: Changed: 3.0.0 does not depend on SFCGAL.
uk: Змінено: 3.0.0 не залежить від SFCGAL.

note: Tag: para
en: Availability: 1.5 support for geography data type was introduced.
uk: Доступність: 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.
uk: Виріжте всі лінії (треки) за країною. Тут ми припускаємо, що геометрія країни є POLYGON або MULTIPOLYGONS. ПРИМІТКА: ми зберігаємо тільки перетини, які утворюють LINESTRING або MULTILINESTRING, оскільки нас не цікавлять траси, які просто мають спільну точку. Дамп необхідний для розширення колекції геометрії в окремі частини MULT*. Нижче наведено досить загальний приклад, який підійде для полігонів тощо, якщо змінити умову 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.)
uk: Для полігонів, наприклад, орієнтирів полігону, ви також можете використовувати іноді швидший хак, який буферизує все, крім полігону, на 0,0, що призводить до порожньої колекції геометрії. (Таким чином, колекція геометрії, що містить полігони, лінії та точки, буферизовані на 0,0, залишить тільки полігони і розчиниться оболонку колекції.)

note: Tag: title
en: Examples: 2.5Dish
uk: Приклади: 2.5D

note: Tag: refpurpose
en: Aggregate function which unions geometries in a memory-efficent but slower way
uk: Агрегатна функція, яка об'єднує геометрії в пам'яті ефективним, але повільнішим способом.

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.
uk: Агрегатна функція, яка об'єднує вхідні геометрії, зливаючи їх для отримання геометрії результату без перекриттів. Результатом може бути одна геометрія, MultiGeometry або Geometry Collection.

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.
uk: Дає той самий результат, що й <xref linkend="ST_Union"/>, але використовує менше пам'яті та більше процесорного часу. Ця агрегатна функція працює шляхом послідовного об'єднання геометрій, на відміну від агрегату ST_Union, який спочатку накопичує масив, а потім об'єднує вміст за допомогою швидкого алгоритму.

note: Tag: refpurpose
en: Nodes a collection of lines.
uk: Вузли — сукупність ліній.

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).
uk: Повертає (Multi)LineString, що представляє повністю вузлову версію колекції лінійних рядків. Вузли зберігають усі вхідні вузли та вводять мінімально можливу кількість нових вузлів. Результуюча лінія розчиняється (дублі ліній видаляються).

note: Tag: para
en: This is a good way to create fully-noded linework suitable for use as input to <xref linkend="ST_Polygonize"/>.
uk: Це хороший спосіб створити повністю вузлові лінії, які можна використовувати як вхідні дані для <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.
uk: також може використовуватися для з'єднання та роз'єднання ліній. Він надає можливість вказати розмір сітки 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.
uk: Змінено: 2.4.0 ця функція використовує GEOSNode внутрішньо замість GEOSUnaryUnion. Це може призвести до того, що отримані лінійні рядки матимуть інший порядок і напрямок порівняно з PostGIS &lt; 2.4.

note: Tag: para
en: Noding a 3D LineString which self-intersects
uk: Вузли 3D-лінії, що перетинається сама з собою

note: Tag: para
en: Noding two LineStrings which share common linework. Note that the result linework is dissolved.
uk: З'єднання двох лінійних об'єктів, які мають спільні лінії. Зверніть увагу, що лінія результату розчиняється.

note: Tag: refpurpose
en: Returns a collection of geometries created by splitting a geometry by another geometry.
uk: Повертає колекцію геометрій, створених шляхом розділення однієї геометрії іншою геометрією.

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.
uk: Функція підтримує розділення LineString за межею (Multi)Point, (Multi)LineString або (Multi)Polygon, або (Multi)Polygon за LineString. Коли (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).
uk: Ця функція в певному сенсі є протилежною до <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.
uk: Якщо вхідні дані та лезо не перетинаються через проблеми з числовою точністю, вхідні дані можуть не розділитися як очікується. Щоб уникнути такої ситуації, може бути необхідним спочатку прив'язати вхідні дані до леза за допомогою <xref linkend="ST_Snap"/> з невеликим допуском.

note: Tag: para
en: Availability: 2.0.0 requires GEOS
uk: Доступність: 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.
uk: Покращено: 2.2.0 додано підтримку розділення лінії мультилінією, мультиточкою або (мульти)полігоном.

note: Tag: para
en: Enhanced: 2.5.0 support for splitting a polygon by a multiline was introduced.
uk: Покращено: 2.5.0 додано підтримку розділення полігону мультилінією.

note: Tag: para
en: Split a Polygon by a Line.
uk: Розділити полігон лінією.

note: Tag: para
en: Before Split
uk: До розділення

note: Tag: para
en: After split
uk: Після розділення

note: Tag: para
en: Split a MultiLineString by a Point, where the point lies exactly on both LineStrings elements.
uk: Розділити MultiLineString за точкою, яка лежить точно на обох елементах LineStrings.

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.
uk: Розділити лінію String за точкою, яка не лежить точно на лінії. Показано за допомогою <xref linkend="ST_Snap"/>, щоб прив'язати лінію до точки, щоб її можна було розділити.

note: Tag: refpurpose
en: Computes a rectilinear subdivision of a geometry.
uk: Обчислює прямолінійний поділ геометрії.

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>.
uk: Повертає набір геометрій, які є результатом поділу <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.
uk: <code>max_vertices</code> має бути 5 або більше, оскільки для зображення закритого прямокутника потрібно 5 точок.

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.
uk: Операції типу "точка в полігоні" та інші просторові операції зазвичай виконуються швидше для індексованих підрозділених набори даних. Оскільки обмежувальні рамки для частин зазвичай охоплюють меншу площу, ніж оригінальна геометрія bbox, запити до індексу дають менше випадків "влучання". Випадки "влучання" обробляються швидше, оскільки просторові операції, що виконуються індексом, перевіряють менше точок.

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.
uk: Це <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.
uk: Покращено: 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.
uk: <emphasis role="bold">Приклад:</emphasis> Розділіть полігон на частини з не більше ніж 10 вершинами та присвойте кожній частині унікальний ідентифікатор.

note: Tag: para
en: Subdivided to maximum 10 vertices
uk: Розділено на максимум 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.
uk: <emphasis role="bold">Приклад:</emphasis> Ущільніть довгу географічну лінію за допомогою ST_Segmentize(geography, distance) і використовуйте ST_Subdivide, щоб розділити отриману лінію на підлінії з 8 вершин.

note: Tag: para
en: The densified and split lines.
uk: Ущільнені та розділені лінії.

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.
uk: <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.
uk: <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.
uk: Обчислює геометрію, що представляє частини геометрій 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>.
uk: Повертає геометрію, що представляє частини геометрій A і B, які не перетинаються. Це еквівалентно <code>ST_Union(A,B) - ST_Intersection(A,B)</code>. Це називається симетричною різницею, оскільки <code>ST_SymDifference(A,B) = ST_SymDifference(B,A)</code>.

note: Tag: para
en: The original linestrings shown together
uk: Оригінальні лініЇ, показані разом

note: Tag: para
en: The symmetric difference of the two linestrings
uk: Симетрична різниця двох лінійних рядків

note: Tag: refpurpose
en: Computes the union of the components of a single geometry.
uk: Обчислює об'єднання компонентів однієї геометрії.

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.
uk: Одновхідний варіант <xref linkend="ST_Union"/>. Вхідними даними може бути одна геометрія, MultiGeometry або GeometryCollection. Об'єднання застосовується до окремих елементів вхідних даних.

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"/>.
uk: Цю функцію можна використовувати для виправлення полігонів MultiPolygons, які є недійсними через перекриття компонентів. Однак кожний з компонентів вхідних даних повинен бути дійсним. Недійсний компонент вхідних даних, такий як полігон у формі метелика, може спричинити помилку. З цієї причини краще використовувати <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.)
uk: Інше застосування цієї функції — об'єднання та роз'єднання набору лінійних рядків, які перетинаються або перекриваються, щоб зробити їх <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"/>.
uk: Можна поєднати 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.
uk: Обчислює геометрію, що представляє об'єднання множин точок вхідних геометрій.

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:
uk: Об'єднує геометрії вхідних даних, об'єднуючи геометрію для отримання геометрії результату без перекриттів. Результатом може бути атомна геометрія, MultiGeometry або колекція геометрій. Існує в декількох варіантах:

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.
uk: <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.
uk: <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.
uk: <emphasis role="bold">Агрегований варіант:</emphasis> повертає геометрію, яка є об'єднанням набору рядків геометрій. Функція ST_Union() є "агрегованою" функцією в термінології PostgreSQL. Це означає, що вона працює з рядками даних так само, як функції SUM() та AVG(), і, як більшість агрегатів, ігнорує геометрії NULL.

note: Tag: para
en: See <xref linkend="ST_UnaryUnion"/> for a non-aggregate, single-input variant.
uk: Див. <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>
uk: Масив 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: 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.
uk: іноді може використовуватися замість 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.
uk: ST_Union створює MultiLineString і не з'єднує LineStrings в один LineString. Для з'єднання LineStrings використовуйте <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.
uk: ПРИМІТКА: раніше ця функція називалася GeomUnion(), але була перейменована з "Union", оскільки 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.
uk: Доступність: 1.4.0 — ST_Union було вдосконалено. Було впроваджено ST_Union(geomarray), а також пришвидшено збір агрегатів у PostgreSQL.

note: Tag: para
en: Aggregate version is not explicitly defined in OGC SPEC.
uk: Агрегована версія не визначена явно в OGC SPEC.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.19 the z-index (elevation) when polygons are involved.
uk: &sqlmm_compliant; SQL-MM 3: 5.1.19 z-індекс (висота) при використанні полігонів.

note: Tag: para
en: Aggregate example
uk: Приклад агрегату

note: Tag: para
en: Non-Aggregate example
uk: Неагрегований приклад

note: Tag: para
en: 3D example - sort of supports 3D (and with mixed dimensions!)
uk: 3D-приклад — часткова підтримка 3D (і з змішаними розмірами!)

note: Tag: para
en: 3d example not mixing dimensions
uk: 3D-приклад без змішування розмірів

note: Tag: title
en: Geometry Processing
uk: Обробка геометрії

note: Tag: para
en: These functions compute geometric constructions, or alter geometry size or shape.
uk: Ці функції обчислюють геометричні конструкції або змінюють розмір чи форму геометрії.

note: Tag: refpurpose
en: Computes a geometry covering all points within a given distance from a geometry.
uk: Обчислює геометрію, що охоплює всі точки в межах заданої відстані від геометрії.

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.
uk: Обчислює 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.
uk: Для геометрії відстань вказується в одиницях просторової системи координат геометрії. Для географії відстань вказується в метрах.

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:
uk: Опціональний третій параметр контролює точність і стиль буфера. Точність кругових дуг у буфері визначається як кількість лінійних сегментів, що використовуються для апроксимації чверті кола (за замовчуванням — 8). Стиль буфера можна вказати, надавши список пар ключ=значення, розділених пробілами, як показано нижче:

note: Tag: para
en: 'quad_segs=#' : number of line segments used to approximate a quarter circle (default is 8).
uk: “quad_segs=#” : кількість відрізків лінії, що використовуються для апроксимації чверті кола (за замовчуванням — 8).

note: Tag: para
en: 'endcap=round|flat|square' : endcap style (defaults to "round"). 'butt' is accepted as a synonym for 'flat'.
uk: “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'.
uk: “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'.
uk: “mitre_limit=#.#” : обмеження кута зрізу (впливає тільки на стиль з'єднання з кутом зрізу). “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.
uk: “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
uk: &geography_transform; Визначає плоску систему просторових координат, яка найкраще відповідає обмежувальній рамці географічного об'єкта (спробує UTM, рівновелику азимутальну проекцію Ламберта (LAEA) з північним/південним полюсом і, нарешті, проекцію Меркатора). Буфер обчислюється в плоскому просторі, а потім перетворюється назад у WGS84. Це може не дати бажаного результату, якщо вхідний об'єкт набагато більший за зону UTM або перетинає лінію зміни дати

note: Tag: para
en: Buffer can handle invalid inputs and the output is always a valid polygonal geometry. Buffering by distance 0 is sometimes used as a way of repairing invalid polygons. <xref linkend="ST_MakeValid"/> is more suitable for this process as it can handle multi-polygons.
uk: Буфер може обробляти недійсні вхідні дані, а вихідні дані завжди мають дійсну полігональну геометрію. Буферизація за відстанню 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"/>.
uk: Буферизація іноді використовується для виконання пошуку в межах певної відстані. Для цього випадку використання ефективніше використовувати <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.
uk: Ця функція ігнорує вимір Z. Вона завжди дає двовимірний результат, навіть якщо використовується для тривимірної геометрії.

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>.
uk: Покращено: 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.
uk: Доступність: 1.5 - ST_Buffer було вдосконалено для підтримки різних кінцевих капсул та типів з'єднання. Це корисно, наприклад, для перетворення лінійних дорожніх об'єктів у полігонні дороги з плоскими або квадратними краями замість заокруглених. Додано тонкий обгортковий об'єкт для географії.

note: Tag: para
en: quad_segs=8 (default)
uk: quad_segs=8 (за замовчуванням)

note: Tag: para
en: quad_segs=2 (lame)
uk: quad_segs=2 (неповноцінний)

note: Tag: para
en: endcap=round join=round (default)
uk: endcap=round join=round (за замовчуванням)

note: Tag: para
en: join=mitre mitre_limit=5.0 (default mitre limit)
uk: join=mitre mitre_limit=5.0 (стандартне обмеження mitre)

note: Tag: refpurpose
en: Creates a polygonal geometry formed by the linework of a geometry.
uk: Створює полігональну геометрію, утворену лініями геометрії.

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.
uk: Створює площинну геометрію, утворену лініями, що складають вхідну геометрію. Вхідними даними можуть бути LineString, MultiLineString, Polygon, MultiPolygon або GeometryCollection. Результатом є Polygon або MultiPolygon, залежно від вхідних даних. Якщо вхідні лінії не утворюють полігонів, повертається 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.
uk: На відміну від <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"/>.
uk: Ця функція перетворює внутрішні кільця на отвори. Щоб перетворити внутрішні кільця також на полігони, використовуйте <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.
uk: Для коректної роботи цієї функції вхідні лінії повинні бути правильно позначені вузлами. Для позначення ліній можна використовувати <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.
uk: Якщо вхідні лінії перетинаються, ця функція створить недійсні полігони. <xref linkend="ST_MakeValid"/>можна використовувати для забезпечення дійсності вихідних даних.

note: Tag: para
en: Input lines
uk: Вхідні лінії

note: Tag: para
en: Area result
uk: Результати за площею

note: Tag: para
en: Create a donut from two circular polygons
uk: Створити кільце з двох круглих полігонів

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)
uk: , <xref linkend="ST_MakePolygon"/>, <xref linkend="ST_MakeValid"/>, <xref linkend="ST_Node"/>, <xref linkend="ST_Polygonize"/>, <xref linkend="ST_BdPolyFromText"/>, <xref linkend="ST_BdMPolyFromText"/> (обгортки для цієї функції зі стандартним інтерфейсом OGC)

note: Tag: refpurpose
en: Returns the geometric center of a geometry.
uk: Повертає геометричний центр геометрії.

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>
uk: Обчислює точку, яка є геометричним центром маси геометрії. Для [<varname>MULTI</varname>]<varname>POINT</varname>s, центроїд є середнім арифметичним вхідних координат. Для [<varname>MULTI</varname>]<varname>LINESTRING</varname>s, центроїд обчислюється за допомогою зваженої довжини кожного відрізка лінії. Для [<varname>MULTI</varname>]<varname>POLYGON</varname>s, центроїд обчислюється за площею. Якщо надано порожню геометрію, повертається порожній <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).
uk: Для вхідних даних змішаного розміру результат дорівнює центроїду компонента Геометрії найвищого розміру (оскільки геометрії нижчого розміру не мають "ваги" для центроїда).

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"/>.
uk: Зверніть увагу, що для полігональних геометрій центр ваги не обов'язково лежить всередині полігону. Наприклад, дивіться схему нижче, що зображує центр ваги С-подібного полігону. Щоб побудувати точку, яка гарантовано лежить всередині полігону, використовуйте <xref linkend="ST_PointOnSurface"/>.

note: Tag: para
en: New in 2.3.0 : supports <varname>CIRCULARSTRING</varname> and <varname>COMPOUNDCURVE</varname> (using CurveToLine)
uk: Нове в версії 2.3.0: підтримка <varname>CIRCULARSTRING</varname> та <varname>COMPOUNDCURVE</varname> (за допомогою CurveToLine)

note: Tag: para
en: Availability: 2.4.0 support for geography was introduced.
uk: Доступність: 2.4.0 додано підтримку географії.

note: Tag: para
en: In the following illustrations the red dot is the centroid of the source geometry.
uk: На наступних ілюстраціях червона точка є центром ваги вихідної геометрії.

note: Tag: para
en: Centroid of a <varname>MULTIPOINT</varname>
uk: Центроїд <varname>MULTIPOINT</varname>

note: Tag: para
en: Centroid of a <varname>LINESTRING</varname>
uk: Центроїд <varname>LINESTRING</varname>

note: Tag: para
en: Centroid of a <varname>POLYGON</varname>
uk: Центроїд <varname>POLYGON</varname>

note: Tag: para
en: Centroid of a <varname>GEOMETRYCOLLECTION</varname>
uk: Центроїд <varname>GEOMETRYCOLLECTION</varname>

note: Tag: refpurpose
en: Returns a smoothed version of a geometry, using the Chaikin algorithm
uk: Повертає згладжену версію геометрії, використовуючи алгоритм Чайкіна.

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.
uk: Згладжує лінійну або полігональну геометрію за допомогою <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.
uk: Якщо <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"/>).
uk: Кількість вершин подвоюється з кожною ітерацією, тому геометрія результату може мати набагато більше точок, ніж вхідні дані. Щоб зменшити кількість точок, скористайтеся функцією спрощення результату (див. <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.
uk: Результатом є інтерпольовані значення для розмірів Z і M, якщо вони присутні.

note: Tag: para
en: Smoothing a triangle:
uk: Згладжування трикутника:

note: Tag: para
en: Smoothing a Polygon using 1, 2 and 3 iterations:
uk: Згладжування полігону за допомогою 1, 2 і 3 ітерацій:

note: Tag: para
en: Smoothing a LineString using 1, 2 and 3 iterations:
uk: Згладжування LineString за допомогою 1, 2 і 3 ітерацій:

note: Tag: refpurpose
en: Computes a possibly concave geometry that contains all input geometry vertices
uk: Обчислює можливу увігнуту геометрію, яка містить усі вершини вхідної геометрії

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.
uk: Увігнутий контур — це (зазвичай) увігнута геометрія, яка містить вхідні дані, а її вершини є підмножиною вершин вхідних даних. У загальному випадку увігнутий корпус є полігоном. Увігнутий корпус двох або більше колінеарних точок є двоточковим LineString. Увігнутий корпус однієї або більше ідентичних точок є точкою. Полігон не буде містити отворів, якщо опціональний аргумент <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.
uk: Уявіть собі увігнутий контур, що "обгортає" набір точок. Це відрізняється від <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.
uk: Параметр <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.
uk: Технічно, параметр <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"/>.
uk: Для точкових і лінійних вхідних даних оболонка охоплюватиме всі точки вхідних даних. Для полігональних вхідних даних оболонка охоплюватиме всі точки вхідних даних <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>.
uk: Це не агрегатна функція. Для обчислення увігнутої оболонки набору геометрій використовуйте <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+
uk: Покращено: 3.3.0, увімкнено вбудовану реалізацію GEOS для GEOS 3.11+

note: Tag: para
en: Concave Hull of a MultiPoint
uk: Увігнутий корпус багатоточкового пристрою

note: Tag: para
en: Concave Hull of a MultiPoint, allowing holes
uk: Увігнутий корпус багатоточкового пристрою, що дозволяє робити отвори

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.
uk: Порівняння увігнутого корпусу полігону з увігнутим корпусом складових точок. Корпус дотримується меж полігону, тоді як оболонка на основі точок цього не робить.

note: Tag: para
en: Using with ST_Collect to compute the concave hull of a geometry set.
uk: Використання з ST_Collect для обчислення увігнутої оболонки набору геометрій.

note: Tag: refpurpose
en: Computes the convex hull of a geometry.
uk: Обчислює опуклу оболонку геометрії.

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.
uk: Обчислює опуклу оболонку геометрії. Опукла оболонка — це найменша опукла геометрія, яка охоплює всі геометрії у вхідних даних.

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.
uk: Опуклу оболонку можна уявити як геометрію, отриману шляхом обертання гумової стрічки навколо набору геометрій. Це відрізняється від <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.
uk: У загальному випадку опукла оболонка є полігоном. Опукла оболонка двох або більше колінеарних точок є двоточковою лінією. Опукла оболонка однієї або більше однакових точок є точкою.

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>.
uk: Це не агрегатна функція. Щоб обчислити опуклу оболонку набору геометрій, використовуйте <xref linkend="ST_Collect"/>, щоб об'єднати їх у колекцію геометрій (наприклад, <code>ST_ConvexHull(ST_Collect(geom))</code>.

note: Tag: para
en: Convex Hull of a MultiLinestring and a MultiPoint
uk: Опукла оболонка багатолінійної та мультиточкової фігури

note: Tag: para
en: Using with ST_Collect to compute the convex hulls of geometry sets.
uk: Використання разом із ST_Collect для обчислення опуклих оболонок наборів геометричних фігур.

note: Tag: refpurpose
en: Returns the Delaunay triangulation of the vertices of a geometry.
uk: Повертає триангуляцію Делауея вершин геометрії.

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:
uk: Обчислює <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)
uk: <code>0</code> - GEOMETRYCOLLECTION трикутних полігонів (за замовчуванням)

note: Tag: para
en: <code>1</code> - a MULTILINESTRING of the edges of the triangulation
uk: <code>1</code> - MULTILINESTRING граней триангуляції

note: Tag: para
en: <code>2</code> - A TIN of the triangulation
uk: <code>2</code> - TIN триангуляції

note: Tag: para
en: Original polygons
uk: Оригінальні полігони

note: Tag: para
en: ST_DelaunayTriangles of 2 polygons: delaunay triangle polygons each triangle themed in different color
uk: ST_DelaunayTriangles з 2 полігонів: трикутники Делоне, кожен трикутник виділений різним кольором

note: Tag: para
en: -- delaunay triangles as multilinestring
uk: -- трикутники Делоне як мультилінія

note: Tag: para
en: -- delaunay triangles of 45 points as 55 triangle polygons
uk: -- трикутники Делоне з 45 точками як 55 трикутних полігонів

note: Tag: para
en: Example using vertices with Z values.
uk: Приклад використання вершин із значеннями Z.

note: Tag: refpurpose
en: Removes vertices based on their M value
uk: Видаляє вершини на основі їхнього значення 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.
uk: Відфільтровує вершинні точки на основі їх M-значення. Повертає геометрію, що містить тільки вершинні точки, M-значення яких більше або дорівнює мінімальному значенню і менше або дорівнює максимальному значенню. Якщо аргумент max-value не вказано, враховується тільки значення min. Якщо четвертий аргумент не вказано, m-значення не буде включено в результуючу геометрію. Якщо в результуючій геометрії залишилося занадто мало вершинних точок для її типу, буде повернута порожня геометрія. У колекції геометрій геометрії без достатньої кількості точок просто пропускаються без повідомлення.

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.
uk: Якщо аргумент <varname>tolerance</varname> не вказано, значення допуску обчислюється на основі розмірів вхідної геометрії.

note: Tag: para
en: If present, the input point M values are interpreted as their relative weights.
uk: Якщо присутні, значення вхідної точки M інтерпретуються як їх відносні ваги.

note: Tag: para
en: Enhanced: 2.5.0 Added support for M as weight of points.
uk: Покращено: 2.5.0 Додано підтримку M як ваги точок.

note: Tag: para
en: Comparison of the geometric median (red) and centroid (turquoise) of a MultiPoint.
uk: Порівняння геометричної медіани (червоний) та центроїда (бірюзовий) MultiPoint.

note: Tag: refpurpose
en: Return the lines formed by sewing together a MultiLineString.
uk: Повернути лінії, утворені зшиванням 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.
uk: Повертає LineString або MultiLineString, утворений шляхом з'єднання лінійних елементів MultiLineString. Лінії з'єднуються в кінцевих точках на двосторонніх перетинах. Лінії не з'єднуються на перетинах з трьома або більше точками.

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
uk: Якщо <emphasis role="bold">directed</emphasis> має значення TRUE, то ST_LineMerge не змінюватиме порядок точок у LineStrings, тому лінії з протилежними напрямками не будуть об'єднані

note: Tag: para
en: Only use with MultiLineString/LineStrings. Other geometry types return an empty GeometryCollection
uk: Використовуйте тільки з MultiLineString/LineStrings. Інші типи геометрії повертають порожній GeometryCollection

note: Tag: para
en: Enhanced: 3.3.0 accept a directed parameter.
uk: Покращено: 3.3.0 приймає спрямований параметр.

note: Tag: para
en: Requires GEOS &gt;= 3.11.0 to use the directed parameter.
uk: Для використання параметра directed необхідна версія GEOS &gt;= 3.11.0.

note: Tag: para
en: This function strips the M dimension.
uk: Ця функція видаляє розмірність M.

note: Tag: para
en: Merging lines with different orientation.
uk: Об'єднання ліній з різною орієнтацією.

note: Tag: para
en: Lines are not merged across intersections with degree &gt; 2.
uk: Лінії не об'єднуються на перетинах зі ступенем &gt; 2.

note: Tag: para
en: If merging is not possible due to non-touching lines, the original MultiLineString is returned.
uk: Якщо об'єднання неможливе через непересічні лінії, повертається оригінальний MultiLineString.

note: Tag: para
en: Lines with opposite directions are not merged if directed = TRUE.
uk: Лінії з протилежними напрямками не об'єднуються, якщо directed = TRUE.

note: Tag: para
en: Example showing Z-dimension handling.
uk: Приклад, що ілюструє обробку Z-виміру.

note: Tag: refpurpose
en: Computes the largest circle contained within a geometry.
uk: Обчислює найбільше коло, що міститься в геометрії.

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:
uk: Знаходить найбільше коло, яке міститься в (мульти)полігоні або не перетинається з лініями та точками. Повертає запис із полями:

note: Tag: para
en: <varname>center</varname> - center point of the circle
uk: <varname>center</varname> - центр кола

note: Tag: para
en: <varname>nearest</varname> - a point on the geometry nearest to the center
uk: <varname>nearest</varname> - точка на геометрії, найближча до центру

note: Tag: para
en: <varname>radius</varname> - radius of the circle
uk: <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.
uk: Для полігональних вхідних даних коло вписується в межі кільця, використовуючи внутрішні кільця як межі. Для лінійних і точкових вхідних даних коло вписується в опуклу оболонку вхідних даних, використовуючи лінії і точки вхідних даних як додаткові межі.

note: Tag: para
en: Availability: 3.1.0.
uk: Доступність: 3.1.0.

note: Tag: para
en: Requires GEOS &gt;= 3.9.0.
uk: Потрібна версія GEOS &gt;= 3.9.0.

note: Tag: para
en: Maximum inscribed circle of a polygon. Center, nearest point, and radius are returned.
uk: Максимальне вписане коло полігону. Повертаються центр, найближча точка та радіус.

note: Tag: para
en: Maximum inscribed circle of a multi-linestring. Center, nearest point, and radius are returned.
uk: Максимальне вписане коло багатолінійної фігури. Повертаються центр, найближча точка та радіус.

note: Tag: refpurpose
en: Computes the largest circle not overlapping a geometry.
uk: Обчислює найбільше коло, яке не перетинається з геометрією.

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.
uk: Знаходить найбільше коло, яке не перетинається з набором точкових і лінійних перешкод. (Полігональні геометрії можуть бути включені як перешкоди, але використовуються тільки їх межі.) Центр кола обмежений межами полігональної фігури, яка за замовчуванням є опуклою оболонкою вхідної геометрії. Центр кола — це точка всередині межі, яка має найбільшу відстань від перешкод. Саме коло задається центром і найближчою точкою, що лежить на перешкоді, яка визначає радіус кола.

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.
uk: Центр кола визначається з заданою точністю, яка визначається допуском на відстань, за допомогою ітераційного алгоритму. Якщо точність відстані не вказана, використовується розумне значення за замовчуванням.

note: Tag: para
en: Returns a record with fields:
uk: Повертає запис із полями:

note: Tag: para
en: To find the largest empty circle in the interior of a polygon, see <xref linkend="ST_MaximumInscribedCircle"/>.
uk: Щоб знайти найбільше порожнє коло всередині полігону, див. <xref linkend="ST_MaximumInscribedCircle"/>.

note: Tag: para
en: Availability: 3.4.0.
uk: Доступність: 3.4.0.

note: Tag: para
en: Largest Empty Circle within a set of lines.
uk: Найбільше порожнє коло в наборі ліній.

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.
uk: Найбільше порожнє коло в наборі точок, обмежене полігоном. Межа полігону обмеження повинна бути включена як перешкода, а також вказана як обмеження для центру кола.

note: Tag: refpurpose
en: <refpurpose>Returns the smallest circle polygon that contains a geometry.</refpurpose>
uk: <refpurpose>Повертає найменший полігон кола, що містить геометрію.</refpurpose>

note: Tag: para
en: <para>Returns the smallest circle polygon that contains a geometry.</para>
uk: <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.
uk: Обмежувальне коло наближається полігоном із 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.
uk: Використовуйте з <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"/>.
uk: Щоб обчислити дві точки, що лежать на мінімальному колі (максимальний діаметр), використовуйте <xref linkend="ST_LongestLine"/>.

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>.
uk: Відношення площі полігону до площі його мінімального обмежувального кола називається <emphasis>коефіцієнтом компактності Реока</emphasis>.

note: Tag: para
en: Minimum bounding circle of a point and linestring. Using 8 segs to approximate a quarter circle
uk: Мінімальне обмежуюче коло точки та лінії. Використання 8 сегментів для наближення чверті кола

note: Tag: refpurpose
en: Returns the center point and radius of the smallest circle that contains a geometry.
uk: Повертає центр і радіус найменшого кола, що містить геометрію.

note: Tag: para
en: Computes the center point and radius of the smallest circle that contains a geometry. Returns a record with fields:
uk: Обчислює центр і радіус найменшого кола, що містить геометрію. Повертає запис із полями:

note: Tag: para
en: Availability - 2.3.0
uk: Доступність - 2.3.0

note: Tag: refpurpose
en: Returns a minimum-area rectangle containing a geometry.
uk: Повертає прямокутник з мінімальною площею, що містить геометрію.

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.
uk: Повертає прямокутник з мінімальною площею, що охоплює геометрію. Зверніть увагу, що може існувати більше одного такого прямокутника. У разі вироджених вхідних даних може повертати Point або LineString.
