pg_eviltransform

概览

版本

构建

您可以使用 pig build 命令构建 pg_eviltransform 扩展的 RPM / DEB 包：

pig build pkg pg_eviltransform         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_eviltransform 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

pig install pg_eviltransform;          # 当前活跃 PG 版本安装

pig ext install -y pg_eviltransform -v 18  # PG 18
pig ext install -y pg_eviltransform -v 17  # PG 17
pig ext install -y pg_eviltransform -v 16  # PG 16
pig ext install -y pg_eviltransform -v 15  # PG 15
pig ext install -y pg_eviltransform -v 14  # PG 14

dnf install -y pg_eviltransform_18       # PG 18
dnf install -y pg_eviltransform_17       # PG 17
dnf install -y pg_eviltransform_16       # PG 16
dnf install -y pg_eviltransform_15       # PG 15
dnf install -y pg_eviltransform_14       # PG 14

apt install -y postgresql-18-eviltransform   # PG 18
apt install -y postgresql-17-eviltransform   # PG 17
apt install -y postgresql-16-eviltransform   # PG 16
apt install -y postgresql-15-eviltransform   # PG 15
apt install -y postgresql-14-eviltransform   # PG 14

创建扩展：

CREATE EXTENSION pg_eviltransform CASCADE;  -- 依赖: postgis

用法

来源：

• Official v0.0.7 README
• v0.0.7 release notes
• v0.0.7 control file
• v0.0.7 upgrade SQL

pg_eviltransform 扩展了 PostGIS，增加了涉及中国 GCJ-02 和 BD-09 系统的坐标转换。版本 0.0.4 还通过 ST_JenksBins 数组和聚合重载添加了精确的 Jenks 自然断点分类。

坐标转换

CREATE EXTENSION postgis;
CREATE EXTENSION pg_eviltransform;

-- WGS84 to GCJ-02 using a readable coordinate-system name.
SELECT ST_EvilTransform(
    ST_SetSRID('POINT(120 30)'::geometry, 4326),
    'GCJ02'
);

-- BD-09 to Web Mercator.
SELECT ST_EvilTransform(
    ST_SetSRID('POINT(120.011070620552 30.0038830555128)'::geometry, 990002),
    3857
);

自定义 SRID 为：990001 对应 GCJ-02，990002 对应 BD-09。当两端均未使用自定义系统时，ST_EvilTransform 将委托给 PostGIS 的 ST_Transform；否则在必要时通过 WGS84 (4326) 转换。

0.0.7 在文本重载中新增地理坐标系 CGCS2000 的别名 CGCS2000、CGCS-2000、4490 和 EPSG:4490，由 PostGIS/PROJ 选择基准转换。使用 CGCS2000 高斯克吕格投影分带时，应传入该分带明确的整数 EPSG SRID。

SELECT ST_EvilTransform(
    ST_SetSRID('POINT(120 30)'::geometry, 4326), 'CGCS2000'
);

Jenks 自然断点

-- Array form; NULL elements are ignored.
SELECT ST_JenksBins(ARRAY[1, 2, NULL, 10, 11]::numeric[], 2);

-- Streaming aggregate form for a large table.
SELECT ST_JenksBins(value, 7)
FROM measurements;

-- Return lower rather than upper bin edges.
SELECT ST_JenksBins(value, 7, true)
FROM measurements;

数组输入支持 numeric, double precision, real, bigint, integer, 和 smallint。聚合输入为 numeric 或 double precision；当需要时请将其他数值列转换为这些类型。

API 索引和注意事项

• ST_EvilTransform(geometry, integer|text) 和 ST_EvilTransform(geometry, text, integer|text)：四个重载对应于 PostGIS 的 ST_Transform 接口。
• ST_JenksBins(values[], breaks [, invert])：对数组进行分类并返回 double precision[] 边界值。
• ST_JenksBins(value, breaks [, invert])：流式聚合，避免生成 array_agg。
• PostGIS 是运行时先决条件，在安装 pg_eviltransform 之前必须已安装。
• Jenks 输入必须是有限的且 breaks 至少为一。numeric 值会被转换为有限的 f64，因此返回的边界值为浮点数。
• 当唯一值的数量不超过 breaks 时，结果将是排序后的唯一值集合；没有有效输入行将返回 NULL。

0.0.7 兼容性

0.0.6 到 0.0.7 的升级 SQL 更新坐标系名称解析函数。上游使用 pgrx 0.19.3，支持 PostgreSQL 14-18 和 PostgreSQL 19 beta4。ST_JenksBins 接口不变；软件包与构建元数据同上游发行版分别维护。