nominatim_fdw
Nominatim 地理编码接口的 FDW 扩展
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
nominatim_fdw | 1.1.0 | FDW | MIT | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 8680 | nominatim_fdw | 否 | 是 | 否 | 是 | 否 | 是 | - |
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 1.1.0 | 1817161514 | nominatim_fdw | - |
| RPM | PGDG | 1.1.0 | 1817161514 | nominatim_fdw_$v | - |
| DEB | PIGSTY | 1.1.0 | 1817161514 | postgresql-$v-nominatim-fdw | - |
构建
您可以使用 pig build 命令构建 nominatim_fdw 扩展的 DEB 包：
pig build pkg nominatim_fdw # 构建 DEB 包
安装
您可以直接安装 nominatim_fdw 扩展包的预置二进制包，首先确保 PGDG 仓库已经添加并启用：
pig repo add pgdg -u # 添加 PGDG 仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install nominatim_fdw; # 当前活跃 PG 版本安装
pig ext install -y nominatim_fdw -v 18 # PG 18
pig ext install -y nominatim_fdw -v 17 # PG 17
pig ext install -y nominatim_fdw -v 16 # PG 16
pig ext install -y nominatim_fdw -v 15 # PG 15
pig ext install -y nominatim_fdw -v 14 # PG 14
dnf install -y nominatim_fdw_18 # PG 18
dnf install -y nominatim_fdw_17 # PG 17
dnf install -y nominatim_fdw_16 # PG 16
dnf install -y nominatim_fdw_15 # PG 15
dnf install -y nominatim_fdw_14 # PG 14
apt install -y postgresql-18-nominatim-fdw # PG 18
apt install -y postgresql-17-nominatim-fdw # PG 17
apt install -y postgresql-16-nominatim-fdw # PG 16
apt install -y postgresql-15-nominatim-fdw # PG 15
apt install -y postgresql-14-nominatim-fdw # PG 14
创建扩展：
CREATE EXTENSION nominatim_fdw;
用法
该 FDW 提供从 PostgreSQL 直接通过 SQL 函数访问 Nominatim 地理编码服务的能力，而非使用传统外部表。
创建服务器
CREATE EXTENSION nominatim_fdw;
CREATE SERVER osm FOREIGN DATA WRAPPER nominatim_fdw
OPTIONS (url 'https://nominatim.openstreetmap.org');
服务器选项： url（必填，Nominatim 端点 URL）、http_proxy、proxy_user、proxy_user_password、connect_timeout（默认 300 秒）、max_connect_retry（默认 3）、max_request_redirect（0 = 无限制）。
地理编码（地址转坐标）
结构化搜索：
SELECT osm_id, ref, lon, lat, boundingbox
FROM nominatim_search(
server_name => 'osm',
street => 'Neubrueckenstrasse 63',
city => 'Muenster',
country => 'Germany'
);
自由格式搜索：
SELECT osm_id, display_name, lon, lat
FROM nominatim_search(
server_name => 'osm',
q => '1600 Pennsylvania Avenue, Washington DC'
);
参数： q（自由格式查询）、street、city、county、state、country、postalcode、amenity、limit（默认 10）、addressdetails、extratags、namedetails。
反向地理编码（坐标转地址）
SELECT osm_id, display_name, boundingbox
FROM nominatim_reverse(
server_name => 'osm',
lon => -77.0365,
lat => 38.8977,
zoom => 18,
addressdetails => true
);
参数： lon、lat（必填）、zoom（默认 18）、addressdetails、extratags、namedetails、layer。
OSM 对象查找
SELECT osm_id, display_name
FROM nominatim_lookup(
server_name => 'osm',
osm_ids => 'W121736959,R123456'
);
参数： osm_ids（逗号分隔的 OSM ID 列表，带类型前缀：N=node，W=way，R=relation）、addressdetails、extratags、namedetails。
版本检查
SELECT nominatim_fdw_version();