Nominatim 命令行工具使用指南

Nominatim 命令行工具使用指南

Nominatim 项目地址: https://gitcode.com/gh_mirrors/nom/Nominatim

概述

Nominatim 是一个开源的地理编码系统，主要用于将地址转换为地理坐标（正向地理编码）以及将地理坐标转换为地址（反向地理编码）。本文重点介绍 Nominatim 提供的命令行工具集，这些工具可用于数据库导入、更新、管理和查询等操作。

主要功能模块

Nominatim 命令行工具提供了多个子命令，每个子命令对应特定的功能：

1. 数据库导入 (import)

创建新的 Nominatim 数据库是使用该系统的基础步骤。nominatim import 命令可以从 OSM 文件导入数据：

nominatim import --osm-file your_data.osm.pbf

常用选项：

• --threads NUM：指定并行线程数
• --osm2pgsql-cache SIZE：设置 osm2pgsql 使用的缓存大小(MB)
• --reverse-only：仅创建反向查询所需的表和索引
• --no-partitions：不分区搜索索引（适用于单个国家/地区数据导入）

2. 数据库冻结 (freeze)

当数据库不再需要更新时，可以使用此命令删除仅用于更新的数据，使数据库变为只读状态：

nominatim freeze

3. 数据更新 (replication)

通过在线复制服务更新数据库：

nominatim replication --init  # 初始化更新过程
nominatim replication --once  # 执行单次更新

4. 特殊短语导入 (special-phrases)

特殊短语是用于缩小搜索对象类型的搜索词，例如"巴塞罗那的酒店"中的"酒店"：

nominatim special-phrases --import-from-wiki  # 从OSM维基导入
nominatim special-phrases --import-from-csv phrases.csv  # 从CSV文件导入

5. 数据添加 (add-data)

向数据库添加额外数据：

nominatim add-data --file new_data.osm  # 从OSM文件添加
nominatim add-data --node 12345  # 通过ID添加单个OSM节点

6. 索引重建 (index)

数据添加或修改后需要重建索引：

nominatim index

可选参数：

• --boundaries-only：仅索引行政边界
• --minrank/--maxrank：指定索引的等级范围

实用工具命令

1. 数据库维护 (admin)

nominatim admin --warm  # 预热数据库缓存
nominatim admin --check-database  # 检查数据库完整性

2. 数据导出 (export)

将地址导出为CSV文件：

nominatim export --output-type street --language zh

3. 开发服务器 (serve)

启动内置PHP Web服务器（仅用于开发和测试）：

nominatim serve

4. 查询功能

Nominatim 提供了多种查询方式：

nominatim search --query "北京大学"  # 正向搜索
nominatim reverse --lat 39.9 --lon 116.3  # 反向查询
nominatim lookup --osm-type N --osm-id 12345  # 通过OSM ID查询

性能优化建议

1. 导入优化：

   • 使用--threads参数充分利用多核CPU
   • 适当增加--osm2pgsql-cache值（建议为可用内存的75%）
   • 对于特定国家/地区数据，使用--no-partitions选项

2. 索引优化：

   • 定期运行nominatim admin --warm预热数据库
   • 使用--boundaries-only或--no-boundaries选择性索引

3. 更新策略：

   • 对于频繁更新的场景，设置定期执行的复制任务
   • 对于静态数据，使用freeze命令减少数据库大小

常见问题解决

1. 导入中断：

   nominatim import --continue load-data
   

   可根据中断点选择load-data、indexing或db-postprocess

2. 函数更新：

   nominatim refresh --functions
   

3. 性能分析：

   nominatim admin --analyse-indexing --osm-id W123456
   

通过掌握这些命令行工具，您可以有效地管理和维护Nominatim地理编码系统，满足各种地理编码需求。

Nominatim 项目地址: https://gitcode.com/gh_mirrors/nom/Nominatim