stefanreuter/nominatim

Nominatim Docker镜像（版本3.1）

镜像概述

本镜像提供OpenStreetMap官方Nominatim地理编码工具的容器化部署方案，支持地址到经纬度的正向解析、经纬度到地址的反向解析，适用于各类需要地理编码能力的应用场景。

核心功能

• 地址正向解析：将文本地址转换为精确经纬度坐标
• 坐标反向解析：将经纬度转换为结构化地址信息
• 支持OpenStreetMap数据的增量更新
• 可分离数据库层与REST服务层，实现灵活扩展部署

使用场景

• 地图应用中的地址搜索与定位功能
• 物流配送系统的位置匹配与路径规划
• 基于位置的服务（LBS）开发与集成
• 地理信息分析与数据可视化

配置说明

1. 构建镜像

bash
docker build -t nominatim .

2. 准备数据文件

将目标区域的OSM数据文件（如<your_country>.osm.pbf）复制到本地目录（例如/home/me/nominatimdata）。

3. 初始化数据库

bash
docker run -t -v /home/me/nominatimdata:/data nominatim sh /app/init.sh /data/merged.osm.pbf postgresdata 4

参数说明：4为导入线程数（建议根据CPU核心数调整），导入过程耗时较长（数小时至数天），完成后可删除merged.osm.pbf文件。

4. 启动单节点服务

bash
docker run --restart=always -p 6432:5432 -p 7070:8080 -d --name nominatim -v /home/me/nominatimdata/postgresdata:/var/lib/postgresql/9.5/main nominatim bash /app/start.sh

5. 高级配置：分离数据库与REST服务

启动数据库节点

bash
docker run --restart=always -p 6432:5432 -d -v /home/me/nominatimdata/postgresdata:/var/lib/postgresql/9.5/main nominatim sh /app/startpostgres.sh

配置REST服务连接

创建/home/me/nominatimdata/conf目录，复制docker/local.php文件至该目录，并取消以下行的注释（替换为实际数据库地址）：

php
@define('CONST_Database_DSN', 'pgsql://nominatim:password1234@192.168.1.128:6432/nominatim'); // <驱动>://<用户名>:<密码>@<主机>:<端口>/<数据库>

启动REST服务节点

bash
docker run --restart=always -p 7070:8080 -d -v /home/me/nominatimdata/conf:/data nominatim sh /app/startapache.sh

6. 增量更新配置

默认更新源为摩纳哥数据，如需修改（例如德国每日更新），在local.php中添加：

php
@define('CONST_Replication_Url', 'http://download.geofabrik.de/europe/germany-updates');

服务启动后，可通过http://localhost:7070/访问Nominatim实例。

更新说明

完整更新文档见https://github.com/openstreetmap/Nominatim/blob/master/docs/admin/Import-and-Update.md#updates%E3%80%82%E6%9F%A5%E7%9C%8B%E6%9B%B4%E6%96%B0%E5%91%BD%E4%BB%A4%E5%88%97%E8%A1%A8%EF%BC%9A

bash
docker exec -it nominatim sudo -u postgres ./src/build/utils/update.php --help

保持数据库实时更新的命令：

bash
docker exec -it nominatim sudo -u postgres ./src/build/utils/update.php --import-osmosis-all

若导入多区域数据需更新，可参考https://github.com/openstreetmap/Nominatim/issues/60%E4%B8%AD%E7%9A%84%E8%84%9A%E6%9C%AC%E3%80%82