pg_eviltransform

基于PostGIS ST_Transform 的 BD09/GCJ02 坐标转换扩展

概览

扩展包名版本分类许可证语言
pg_eviltransform0.0.2GISMITRust
ID扩展名BinLibLoadCreateTrustReloc模式
1580pg_eviltransformeviltransform_internal
相关扩展postgis postgis pgrouting pg_geohash h3 q3c earthdistance tzf geoip

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY0.0.21817161514pg_eviltransformpostgis
RPMPIGSTY0.0.21817161514pg_eviltransform_$vpostgis36_$v
DEBPIGSTY0.0.21817161514postgresql-$v-eviltransformpostgresql-$v-postgis
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
d12.x86_64
d12.aarch64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
d13.x86_64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
d13.aarch64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
u22.x86_64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
u22.aarch64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
u24.x86_64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
u24.aarch64
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2
PIGSTY 0.0.2

构建

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

pig build pkg pg_eviltransform         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_eviltransform 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

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

用法

pg_eviltransform: WGS84、GCJ02 和 BD09 之间的坐标转换

pg_eviltransform 为 PostGIS 的 ST_Transform 扩展了 BD09/GCJ02 中国坐标系支持。它暴露了 ST_EvilTransform 函数,与 ST_Transform 具有相同的重载接口。

自定义 SRID:

  • 990001:GCJ02(火星坐标系)
  • 990002:BD09(百度坐标系)

函数

ST_EvilTransform(geometry, to_srid integer)
ST_EvilTransform(geometry, to_proj text)
ST_EvilTransform(geometry, from_proj text, to_srid integer)
ST_EvilTransform(geometry, from_proj text, to_proj text)

如果双方都不涉及自定义坐标系,则直接委托给 ST_Transform。如果涉及 BD09/GCJ02,会在需要时通过 WGS84(4326)进行中转。

示例

-- WGS84 转 GCJ02(使用文本字面量)
SELECT ST_EvilTransform(ST_SetSRID('POINT(120 30)'::geometry, 4326), 'GCJ02');

-- WGS84 转 BD09(使用文本字面量)
SELECT ST_EvilTransform(ST_SetSRID('POINT(120 30)'::geometry, 4326), 'BD09');

-- WGS84 转 GCJ02(使用数字 SRID)
SELECT ST_EvilTransform(ST_SetSRID('POINT(120 30)'::geometry, 4326), 990001);

-- BD09 转 Web Mercator
SELECT ST_EvilTransform(
  ST_SetSRID('POINT(120.011070620552 30.0038830555128)'::geometry, 990002), 3857
);

-- from_proj / to_proj 重载
SELECT ST_EvilTransform('POINT(120 30)'::geometry, 'EPSG:4326', 'GCJ02');

性能

在 PG18 上处理 200,000 行数据时,ST_EvilTransform 比基于正则表达式的 SQL 方法快约 30-45 倍。


最后修改 2026-03-14: update extension metadata (953cbd0)