nominatim_fdw
Nominatim 地理编码接口的 FDW 扩展
仓库
jimjonesbr/nominatim_fdw
https://github.com/jimjonesbr/nominatim_fdw
源码
nominatim_fdw-1.2.tar.gz
nominatim_fdw-1.2.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
nominatim_fdw | 1.2 | FDW | MIT | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 8680 | nominatim_fdw | 否 | 是 | 否 | 是 | 否 | 是 | - |
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 1.2 | 1817161514 | nominatim_fdw | - |
| RPM | PGDG | 1.2 | 1817161514 | nominatim_fdw_$v | - |
| DEB | PIGSTY | 1.2 | 1817161514 | postgresql-$v-nominatim-fdw | - |
构建
您可以使用 pig build 命令构建 nominatim_fdw 扩展的 RPM / DEB 包：
pig build pkg nominatim_fdw # 构建 RPM / 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;
用法
nominatim_fdw 是一个 PostgreSQL 风格的 FDW 扩展，用于从 SQL 中调用 Nominatim 地理编码服务。该扩展围绕函数而不是外部表组织，并映射到 Nominatim 的 search、reverse 和 lookup 端点。
服务器配置
先创建扩展，再定义一个指向 Nominatim 端点的服务器：
CREATE EXTENSION nominatim_fdw;
CREATE SERVER osm
FOREIGN DATA WRAPPER nominatim_fdw
OPTIONS (url 'https://nominatim.openstreetmap.org');
README 记录的服务器选项包括：
url，必填的端点 URLhttp_proxyconnect_timeout，默认300max_connect_retry，默认3max_connect_redirect，其中0表示无限重定向
服务器选项可通过 ALTER SERVER 修改：
ALTER SERVER osm OPTIONS (ADD max_connect_retry '5');
ALTER SERVER osm OPTIONS (SET url 'https://a.new.url');
ALTER SERVER osm OPTIONS (DROP http_proxy);
代理凭据应放在用户映射中，而不是服务器定义中：
CREATE USER MAPPING FOR pguser
SERVER osm
OPTIONS (proxy_user 'myuser', proxy_password 'mysecret');
地理编码函数
搜索
nominatim_search 同时支持结构化查询和自由格式查询：
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'
);
反向地理编码
SELECT osm_id, display_name, boundingbox
FROM nominatim_reverse(
server_name => 'osm',
lon => -77.0365,
lat => 38.8977,
zoom => 18,
addressdetails => true
);
OSM 对象查找
SELECT osm_id, display_name
FROM nominatim_lookup(
server_name => 'osm',
osm_ids => 'W121736959,R123456'
);
README 说明查找 ID 使用 OSM 类型前缀，例如 N 表示 node、W 表示 way、R 表示 relation。
说明
当前上游 README 列出的依赖要求包括：
- PostgreSQL 12 或更高版本
libxml22.5.0 或更高版本libcurl7.74.0 或更高版本
该扩展还暴露 nominatim_fdw_version() 用于版本检查，并支持通过 ALTER EXTENSION nominatim_fdw UPDATE 进行升级。