为 Pelias 地理编码器提供 HTTP API，将地址与坐标互相转换并以 GeoJSON 返回结果。
MIT
```bash
npm install
``````bash
PELIAS_CONFIG=/path/to/pelias.json npm run start
```产品信息
- 形态
- API / SDK / 库
- 分类
- 生活与娱乐 › 天气与地图
- 定价
- 开源
- 授权协议
- MIT
- 首发日期
- 2026年9月28日
- 收录时间
- 2026年9月28日
概览
Pelias API 是 Pelias 项目的 API 服务器，负责处理用户的 HTTP 请求，通过查询 Elasticsearch 及其他 Pelias 服务，将结果以 GeoJSON 格式返回。 Pelias 本身是一个完全由开放数据驱动的模块化开源地理编码搜索引擎，能够将地址和地名转换为地理坐标，也能将地理坐标反向解析为具体的地点和地址。 ### 主要能力 - **地理编码与逆地理编码**：支持将用户输入的地点搜索转化为可操作的地理数据，或将地理数据还原为真实地点。 - **GeoJSON 响应**：所有查询结果统一以 GeoJSON 格式输出，便于前端或下游系统直接消费。 - **多服务集成**：可通过配置文件接入 point-in-polygon、libpostal、placeholder、interpolation 等辅助服务。 - **灵活的配置项**：支持自定义 Elasticsearch 索引名、默认焦点坐标、结果数量限制（minSize、maxSize、defaultSize）、特定来源和图层的权重提升（customBoosts）以及自动发现 sources 和 layers 等。 - **性能优化选项**：例如 `autocomplete.exclude_address_length` 可在自动补全时排除过短查询的地址层结果，减少在大规模地址库中的检索开销。 ### 运行环境 该服务使用 JavaScript 编写，除 Node.js 外无其他外部依赖。通过 `npm install` 安装后即可使用 `npm start` 启动服务。配置通过环境变量 `PELIAS_CONFIG` 指定 JSON 文件路径加载。 ### 适用场景 适合需要自建地理编码服务、希望基于开放数据进行地点搜索的开发者或团队。项目采用 MIT 协议开源，也可通过 Geocode Earth 获取云端 Web 服务。
功能特性
- HTTP API 服务：接收用户 HTTP 请求并返回 GeoJSON 格式的地理编码结果。
- Elasticsearch 查询：通过查询 Elasticsearch 集群获取地点与地址数据。
- 多服务集成：支持配置 placeholder、libpostal、pip、interpolation 等辅助服务。
- 自定义结果数量：可通过 minSize、maxSize、defaultSize 控制单次查询返回的结果数。
- 自动发现图层与来源：启动时自动查询 Elasticsearch 发现可用的 sources 和 layers。
- 自定义权重：通过 customBoosts 为特定来源或图层配置权重以影响排序。
- 自动补全性能优化：可设置字符长度阈值，在短查询时排除地址层以提升性能。
- 归一化置信度评分：relativeScores 参数控制是否对结果的置信度分数进行归一化。
- 访问日志配置：支持使用 morgan 预定义格式配置访问日志，或完全禁用。
版本更新
新版本提醒我
首个版本 · Pelias APIQ&A
- Pelias API 除了 Node.js 还有其他依赖吗？由 AI 生成
- 没有。原文指出 Pelias API 除 Node.js 之外没有任何依赖，通过 npm install 即可安装。
- 如何指定自定义配置文件启动服务？由 AI 生成
- 通过设置环境变量 PELIAS_CONFIG 指向你的 pelias.json 配置文件路径，然后执行 npm run start 即可。
- API 返回的数据格式是什么？由 AI 生成
- API 处理用户请求后，会将结果以 GeoJSON 格式返回。
- 可以限制查询返回的结果数量吗？由 AI 生成
- 可以。通过配置 minSize（默认1）、maxSize（默认40）和 defaultSize（默认10）来控制查询返回的结果数量范围。
收藏
这个产品还没有主理人
由平台收录或原作者已注销。如果它是你的作品，证明与它的关系后即可成为主理人。
认领这个产品