ORS API（OpenRouteService）
2026年07月09日 09:06

GISBox是一站式三维GIS数据编辑、转换、发布平台，支持OSGB/GEOTIFF/RVT等多种GIS格式编辑，转换为3DTiles/Terrain等并发布。

简介

ORS API（OpenRouteService）是一款基于OpenStreetMap数据的开源地理空间路线规划服务，提供RESTful接口，支持驾车、步行、骑行等多种交通方式的路径规划，以及等时线分析、距离矩阵计算、地理编码、高程查询、轨迹匹配和多点路线优化等功能。它基于Java开发，遵循GPLv3开源协议，可通过Docker等方式自行部署，也可直接调用其公共API，广泛应用于导航应用、物流配送、城市规划和户外运动等场景。

文件结构

‌ORS（OpenRouteService）核心项目的文件结构主要如下：

  1. docs/‌：项目文档目录，包含用户手册、API 接口说明、配置指南等文档资料。
  2. docs/run-instance/configuration/‌：专门存放服务部署与运行配置文件的目录，核心文件为 ‌ors-config.yml‌。
  3. ors-engine/‌：路由引擎核心模块目录，负责路径计算、等时线分析、矩阵计算等核心算法逻辑。
  4. ors-engine/src/main/files/osm/‌：用于存放 OpenStreetMap（OSM）数据文件的目录，需将地图数据放置于此并在配置中引用。
  5. logs/‌：日志目录，服务运行产生的日志文件（如ors.log）存放于此，用于排查错误和运行状态监控。
  6. ors-api/‌：RESTful API 接口层目录，对外暴露 /v2/directions、/v2/isochrones、/v2/matrix、/v1/geocode、/v2/status 等 HTTP 端点。
  7. tests/‌：测试套件目录，包含单元测试和集成测试代码。
  8. docker/‌（或相关部署目录）：包含 Docker 部署所需的配置文件（如 Dockerfile、docker-compose.yml 等），便于容器化部署。

优点

  1. 完全开源免费‌：基于GPLv3许可协议，无需支付 API 调用费用或许可费用，成本仅涉及服务器硬件与数据存储，通过Docker即可快速部署。
  2. 数据隐私与主权可控‌：支持本地化部署，所有路线计算和地理编码在自有服务器上完成，敏感位置数据不出企业内网，满足GDPR等隐私合规要求。
  3. 功能丰富且模块化‌：提供方向导航、等时线分析、距离/时间矩阵、地理编码、高程查询、轨迹匹配等多种API端点，支持驾车、步行、骑行、轮椅等多种交通模式。
  4. 高度可定制‌：可自定义路由规则、速度配置、转弯成本、道路类型偏好、避免区域、自定义权重函数等，满足物流、城市规划、户外运动等特殊场景需求。
  5. 技术自主性强‌：代码永久可访问，不受商业服务涨价、接口变更或停服风险影响，社区持续维护，项目可持续发展。开发包‌：官方提供Python SDK，便于在脚本和自动化流程中集成云端GIS数据操作。
  6. 活跃的社区与文档‌：拥有详尽的官方文档、Swagger UI交互式测试界面、多语言客户端库（Python、JavaScript、Dart等）及丰富的案例库。

缺点

  1. 部署与配置门槛较高‌：强制要求通过环境变量指定配置文件路径，不符合"开箱即用"原则，新用户需额外配置才能运行；首次部署需手动下载OSM数据、编写YAML配置文件并启动Java服务。
  2. 路网数据存在滞后与偏差‌：不同出行模式的OSM数据更新周期不一（驾车季度更新、骑行年度更新、步行半年更新等），存在单行道缺失、立交桥层级忽略、人行天桥未纳入、坡度精度不足等问题。
  3. 性能与资源依赖大‌：基于Java开发，路线计算需较高内存与CPU资源（建议JVM分配4–8G内存），大数据量场景需分块处理和SSD存储支持；自建服务需自行承担运维和优化工作。
  4. 矩阵功能不返回具体路径‌：时空矩阵（Matrix）API只能计算多点间的距离和时间，无法返回两点之间的具体路线几何信息。
  5. 实时交通数据支持有限‌：ORS本身不提供实时路况，需额外付费接入TomTom、Here等第三方数据源才能实现动态路由规划。
  6. 免费公共API有调用限制‌：官方公共API免费账户每月仅 500 次请求额度，超出后返回403错误，高流量应用仍需自建实例。

应用场景

ORS API广泛应用于物流与配送领域，用于规划多站点最优派送路线和计算配送等时范围；在城市规划与交通管理中，可辅助分析步行骑行友好性、评估道路可达性及进行公共交通站点覆盖分析；户外运动与旅游场景下，它为徒步、骑行应用提供轨迹导航与距离计算服务；此外，它还可用于应急救援中的最短路径搜索、房地产的通勤时间评估、以及科研机构的空间可达性与出行行为研究等多种场景。

示例图

1. 经典地图客户端。

Snipaste_2026-07-09_09-35-42.jpg

文件打开方式

1. 通过OpenRouteService，从当前位置计算到标记位置的路线。

Snipaste_2026-07-09_09-36-55.jpg

相关 GIS 服务

Web 地图渲染服务 OGC API

切片地图服务

HERE Technologies

Azure Maps API

参考资料

  1. https://openrouteservice.org/
  2. https://pygmalion.nitri.org/how-to-enable-basic-routing-with-openrouteservice-ors-in-opentopomap-viewer-1818.html
  3. https://ask.openrouteservice.org/t/installing-ors-map-to-existing-vue-project/4476