Pelias API

Overview

GitHubGitHub

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 服务。

Q&A

Pelias API 除了 Node.js 还有其他依赖吗？AI-generated

没有。原文指出 Pelias API 除 Node.js 之外没有任何依赖，通过 npm install 即可安装。

如何指定自定义配置文件启动服务？AI-generated

通过设置环境变量 PELIAS_CONFIG 指向你的 pelias.json 配置文件路径，然后执行 npm run start 即可。

API 返回的数据格式是什么？AI-generated

API 处理用户请求后，会将结果以 GeoJSON 格式返回。

可以限制查询返回的结果数量吗？AI-generated

可以。通过配置 minSize（默认1）、maxSize（默认40）和 defaultSize（默认10）来控制查询返回的结果数量范围。