后端【免费下载链接】valhallaOpen Source Routing Engine for OpenStreetMap项目地址https://gitcode.com/gh_mirrors/va/valhalla点击查看免费下载Valhalla 是一个基于 OpenStreetMap 数据的开源路由引擎本文以官方入门文档为主体梳理其公共演示服务器、多模式路由、瓦片化层级数据、动态成本模型与导航叙事生成五大核心设计并结合仓库源码与架构文档展开实现级解读。读完本文你将掌握 Valhalla 的设计哲学、各核心模块LOKI/THOR/SIF/BALDR/ODIN/TYR的分工与协作方式以及从体验公共服务器到理解自建路由服务的技术路径。公共演示服务器零成本体验完整功能Valhalla 由 FOSSGIS e.V. 托管了一个功能完整的公共演示服务器对公众开放并内置了完整的全球路网数据full planet graph以及一个开源 Web 应用。入口地址为Web 演示应用https://valhalla.openstreetmap.deHTTP API位于略有不同的子域例如 https://valhalla1.openstreetmap.de/status公共演示服务器的使用遵循与 OSRM、Nominatim 演示服务器相同的合理使用政策fair-usage policy并在一定程度上通过速率限制来执行。需要注意的是如果你的应用无论是移动端、Web 端还是桌面端要向公共演示服务器发起请求并发布给最终用户官方希望你先通过 Github Discussions 告知并在请求中带上可识别的X-Client-Id请求头例如X-Client-Id: newroutingapp.io这一约定既帮助维护方了解公共资源的使用情况也为接入方提供了与维护团队建立沟通的渠道。对开发者而言这意味着在正式自建服务之前可以用公共服务器快速验证 API 行为与路由效果而对生产级应用则应基于下文所述的自建瓦片与服务方案搭建独立环境。设计理念把属性留给图数据把决策留给运行时成本模型Valhalla 与许多源于学术研究的既有开源路由引擎不同后者的优势在于算法在大型图/路网上的速度但大量道路属性需要被折叠进固定的成本模型baked costing model中。Valhalla 的选择恰恰相反——将大部分属性添加到图数据中并允许动态、运行时的成本计算dynamic, run-time costing。这一设计带来两个直接收益社区可贡献任何人都可以贡献并应用自己的成本模型灵活生成不同特征的路线通过替换或组合成本模型在同一份数据上产出具有不同特征的路线而无需重新生成数据集。从源码结构看这一理念落实为 src/sif 下的多个成本模型实现例如 autocost.cc汽车、pedestriancost.cc步行、bicyclecost.cc自行车、transitcost.cc公共交通与 truckcost.cc卡车。这些模型在路由引擎 THOR 遍历图时被动态调用从而让“同一份瓦片数据、多种出行方式”成为可能。多模态与时间相关路由同一路线里混排多种出行方式Valhalla 最初的开发阶段聚焦于单模式出行但设计目标是快速支持在同一条路线中混合汽车、步行、自行车与公共交通。官方文档明确指出从第一天起Valhalla 的设计就受到多模态考量的影响。支持公共交通意味着必须实现时间与时刻表相关的路由time and schedule dependent routing——路由过程需要沿路径跟踪时间并且能够支持“必须在某个时间点到达某地”的约束即给定到达时间。这一能力在 THOR 路由引擎的算法家族中得到落实。根据 THOR 架构文档所有路径计算算法均继承自基类PathAlgorithmAStar正向 A* 算法目前仅用于“平凡路径”起点与终点在同一条边或相邻相连的边上TimeDepForward正向 A*用于指定出发时间的时间相关路由TimeDepReverse反向 A*用于指定到达时间的时间相关路由BidirectionalAStar双向 A*用于非时间相关且非平凡的路由MultiModal带公交时刻表查询的正向 A*包含步行与公交之间的模式切换逻辑因公交时刻表本质上是时间相关的。对应实现可在 src/thor 中查看如 bidirectional_astar.cc、unidirectional_astar.cc 与 multimodal_astar.cc。时间相关路径的验证逻辑则可参考 test/timedep_paths.cc。瓦片化层级数据像矢量地图一样管理路由数据从 OSM 构建路由数据集并非易事。Valhalla 的核心疑问是为什么路由数据不能像矢量地图数据一样处理答案是采用瓦片数据结构tiled data structure从而允许轻松下载和更新区域数据。图路由数据结构瓦片可以被下载用于客户端路由应用或供不想经历数据创建痛苦的主机托管服务直接使用。同时结构化的图层级例如高速公路、主干道、支路、公交配合捷径边shortcut edges确保路由的高性能。THOR 正是 Tiled Hierarchical Open Routing瓦片化层级开放路由的缩写是整个 Valhalla 组织及其北欧神话命名主题的奠基思想。这一特性在 BALDR 架构文档 中有更细致的描述BALDRBase ALgorithms and Data Resource提供路由专用数据结构负责路由数据瓦片、瓦片缓存、层级瓦片布局以及瓦片数据成员节点、边、出口等。其核心类型GraphId是瓦片化层级图内节点/边的唯一标识内部以 64 位无符号整数表示包含 3 位层级level、22 位瓦片索引tileid与 21 位节点/边索引id。具体实现可参考 graphid.cc 与头文件 valhalla/baldr/graphid.h。瓦片化带来另一个连锁优势LOKI 定位引擎可以借助瓦片的规则网格与层级结构把坐标关联搜索限制在靠近输入点的少量瓦片上。根据 LOKI 架构文档LOKI 只关心最详细的层级因为它拥有图中所有边并利用每个瓦片内 5x5 的边索引分箱bins实现“按距离最近优先”的迭代搜索——实测文档数据中位耗时从初版的 130ms纽约降到 4ms纽约而全球瓦片集的数据体积增幅小于 5%。取走你的路线TYR为移动端与离线场景而生的服务层TYR 是 Valhalla 的服务层接收地点与选项作为输入返回路线与机动操作maneuvers作为输出本质上将 Valhalla 组织下的所有其他项目串联起来。TYR 是 Take Your Route取走你的路线的回文缩写对应北欧神话中战神提尔之名。TYR 最初定位为路由服务用户可以借此为移动端或 Web 端生成路线。官方规划的扩展方向包括提供下载瓦片路由数据的方法支持无连接、客户端侧的离线路由用户在路上“取走你的路线”Take Your Route或为某一区域下载图瓦片在没有网络连接的地方继续使用设备客户端侧“返回路线”return to route与离线路由等功能均因此成为可能。从实现角度看TYR 的核心职责是数据编组data marshalling、HTTP、请求解析、响应序列化与进程间通信。仓库中的对应实现包括 src/tyr/actor.cc 与 src/valhalla_service.cc而序列化层则体现在 route_serializer_valhalla.cc、route_serializer_osrm.ccOSRM 兼容输出等文件中。灵活性与可扩展性动态成本与可定制叙事Valhalla 鼓励社区贡献各自国家和地区的专业知识与本地知识。其核心支撑点是动态成本dynamic costing。一个地区的好路线在另一地区未必成立因此可动态、可扩展的“插件式”成本/权重代码具有重要意义。动态成本还带来两个实际收益运行时生成替代路线——无需生成不同数据集即可在运行期为同一请求产出备选路径支持专业化场景的新成本方法——例如卡车路由、绿色/环保路由以及未来可能的低成本least cost路由。在 SIF 架构文档 中SIF 被描述为“为边以及边之间的转换转弯成本提供动态、可扩展的计费”其主要用途是在路由引擎 THOR 形成最优路径时发挥作用。仓库中 src/sif/dynamiccost.cc 与 src/sif/recost.cc 进一步体现了运行时重新计费的机制而各出行方式的成本参数则在 proto/options.proto 中定义如costing、costing_options等字段供请求时动态指定。在叙事与引导生成方面Valhalla 同样希望提供添加自定义叙事短语的途径以及扩展或添加自定义插件的其他方式以便按用户需求定制输出。开放方向与改进叙事ODIN把路径变成能听懂的方向一条高质量的路线结果远不止一条路径形状和“左转/右转/继续直行”的简单列表。ODINOpen Directions and Improved Narrative负责将路径信息转换为易于理解、实用、能在旅途中真正帮助用户的引导与叙事方向。高速公路的出口信息与方向信息将帮助消除沿途关键决策点的歧义。例如从51B出口靠右驶入I 81 North前往I 78/Hazleton/Allentown。ODIN 使用常见基础路名合并机动操作collapse maneuvers并简化复杂交叉路口的转换地标landmarks及其他相关信息也在规划之中。由于引导与路线说明必须能适配不同语言和不同使用场景可扩展性与社区贡献是这一模块的关键。根据 ODIN 架构文档ODIN 包含一组数据结构和算法负责机动操作生成、路名匹配与叙事生成。仓库中的对应实现包括 maneuversbuilder.cc、narrativebuilder.cc 与 directionsbuilder.cc多语言文案资源位于 locales 目录如 en-US.json、de-DE.json而发音与路名格式化逻辑则见 verbal_text_formatter.cc。从体验者到构建者下一步可以做什么入门文档之后你可以沿着以下路径继续深入阅读架构文档了解 LOKI定位、THOR路由、SIF成本、BALDR瓦片数据、ODIN导航、TYR服务 以及地理/数学基础库 MIDGARD 和海拔数据模块 SKADI 的完整分工查看构建工具仓库 scripts 目录提供了 valhalla_build_config 等配置生成脚本src/mjolnir 下则有 valhalla_build_tiles.cc、valhalla_build_admins.cc 等瓦片构建命令行工具体验测试test 目录包含大量可运行的单元测试与 gurka 集成测试框架可用于验证路由、成本与叙事行为了解 API访问 docs/docs/api 下的 API 文档含 JSON 示例与参数定义掌握 route、matrix、isochrone、trace 等端点的请求格式。概括而言Valhalla 的入门价值在于它把“高质量的路线”拆解为可独立演进的数据层BALDR、定位层LOKI、成本层SIF、算法层THOR、叙事层ODIN与服务层TYR并通过动态成本与插件机制让社区能够在共享同一份全球瓦片数据的前提下按地区、按场景定制属于自己的路由体验。赞分享后端【免费下载链接】valhallaOpen Source Routing Engine for OpenStreetMap项目地址https://gitcode.com/gh_mirrors/va/valhalla点击查看免费下载相关推荐电子课本PDF批量下载3步攒齐一学期教材电子课本PDF批量下载3步攒齐一学期教材 跑完之后你选定的文件夹里已经躺着一批以教材名称命名的课本 PDF部分教材的朗读音频还整整齐齐地放在子目录里。干这后端Valhalla入门指南开源路由引擎的完整介绍Valhalla是一款功能强大的开源路由引擎专门用于处理开放地图数据提供完整的地理路由和路径规划解决方案。这个高性能路由引擎支持多种交通模式包括汽车、自行后端从汇编翻回可读 C 代码LLM4Decompile 反编译实战解析从汇编翻回可读 C 代码LLM4Decompile 反编译实战解析 LLM4Decompile 用大语言模型做反编译把 Linux x86_64 二进制里的后端上一篇从构建到性能剖析Ceph Crimson 开发者实战指南下一篇Table Transformer项目实战表格检测与结构识别全流程指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/10 1:27:41 · 阅读 1.2k Valhalla 入门指南：OpenStreetMap 开源路由引擎的核心特性与架构解析
后端【免费下载链接】valhallaOpen Source Routing Engine for OpenStreetMap项目地址https://gitcode.com/gh_mirrors/va/valhalla点击查看免费下载Valhalla 是一个基于 OpenStreetMap 数据的开源路由引擎本文以官方入门文档为主体梳理其公共演示服务器、多模式路由、瓦片化层级数据、动态成本模型与导航叙事生成五大核心设计并结合仓库源码与架构文档展开实现级解读。读完本文你将掌握 Valhalla 的设计哲学、各核心模块LOKI/THOR/SIF/BALDR/ODIN/TYR的分工与协作方式以及从体验公共服务器到理解自建路由服务的技术路径。公共演示服务器零成本体验完整功能Valhalla 由 FOSSGIS e.V. 托管了一个功能完整的公共演示服务器对公众开放并内置了完整的全球路网数据full planet graph以及一个开源 Web 应用。入口地址为Web 演示应用https://valhalla.openstreetmap.deHTTP API位于略有不同的子域例如 https://valhalla1.openstreetmap.de/status公共演示服务器的使用遵循与 OSRM、Nominatim 演示服务器相同的合理使用政策fair-usage policy并在一定程度上通过速率限制来执行。需要注意的是如果你的应用无论是移动端、Web 端还是桌面端要向公共演示服务器发起请求并发布给最终用户官方希望你先通过 Github Discussions 告知并在请求中带上可识别的X-Client-Id请求头例如X-Client-Id: newroutingapp.io这一约定既帮助维护方了解公共资源的使用情况也为接入方提供了与维护团队建立沟通的渠道。对开发者而言这意味着在正式自建服务之前可以用公共服务器快速验证 API 行为与路由效果而对生产级应用则应基于下文所述的自建瓦片与服务方案搭建独立环境。设计理念把属性留给图数据把决策留给运行时成本模型Valhalla 与许多源于学术研究的既有开源路由引擎不同后者的优势在于算法在大型图/路网上的速度但大量道路属性需要被折叠进固定的成本模型baked costing model中。Valhalla 的选择恰恰相反——将大部分属性添加到图数据中并允许动态、运行时的成本计算dynamic, run-time costing。这一设计带来两个直接收益社区可贡献任何人都可以贡献并应用自己的成本模型灵活生成不同特征的路线通过替换或组合成本模型在同一份数据上产出具有不同特征的路线而无需重新生成数据集。从源码结构看这一理念落实为 src/sif 下的多个成本模型实现例如 autocost.cc汽车、pedestriancost.cc步行、bicyclecost.cc自行车、transitcost.cc公共交通与 truckcost.cc卡车。这些模型在路由引擎 THOR 遍历图时被动态调用从而让“同一份瓦片数据、多种出行方式”成为可能。多模态与时间相关路由同一路线里混排多种出行方式Valhalla 最初的开发阶段聚焦于单模式出行但设计目标是快速支持在同一条路线中混合汽车、步行、自行车与公共交通。官方文档明确指出从第一天起Valhalla 的设计就受到多模态考量的影响。支持公共交通意味着必须实现时间与时刻表相关的路由time and schedule dependent routing——路由过程需要沿路径跟踪时间并且能够支持“必须在某个时间点到达某地”的约束即给定到达时间。这一能力在 THOR 路由引擎的算法家族中得到落实。根据 THOR 架构文档所有路径计算算法均继承自基类PathAlgorithmAStar正向 A* 算法目前仅用于“平凡路径”起点与终点在同一条边或相邻相连的边上TimeDepForward正向 A*用于指定出发时间的时间相关路由TimeDepReverse反向 A*用于指定到达时间的时间相关路由BidirectionalAStar双向 A*用于非时间相关且非平凡的路由MultiModal带公交时刻表查询的正向 A*包含步行与公交之间的模式切换逻辑因公交时刻表本质上是时间相关的。对应实现可在 src/thor 中查看如 bidirectional_astar.cc、unidirectional_astar.cc 与 multimodal_astar.cc。时间相关路径的验证逻辑则可参考 test/timedep_paths.cc。瓦片化层级数据像矢量地图一样管理路由数据从 OSM 构建路由数据集并非易事。Valhalla 的核心疑问是为什么路由数据不能像矢量地图数据一样处理答案是采用瓦片数据结构tiled data structure从而允许轻松下载和更新区域数据。图路由数据结构瓦片可以被下载用于客户端路由应用或供不想经历数据创建痛苦的主机托管服务直接使用。同时结构化的图层级例如高速公路、主干道、支路、公交配合捷径边shortcut edges确保路由的高性能。THOR 正是 Tiled Hierarchical Open Routing瓦片化层级开放路由的缩写是整个 Valhalla 组织及其北欧神话命名主题的奠基思想。这一特性在 BALDR 架构文档 中有更细致的描述BALDRBase ALgorithms and Data Resource提供路由专用数据结构负责路由数据瓦片、瓦片缓存、层级瓦片布局以及瓦片数据成员节点、边、出口等。其核心类型GraphId是瓦片化层级图内节点/边的唯一标识内部以 64 位无符号整数表示包含 3 位层级level、22 位瓦片索引tileid与 21 位节点/边索引id。具体实现可参考 graphid.cc 与头文件 valhalla/baldr/graphid.h。瓦片化带来另一个连锁优势LOKI 定位引擎可以借助瓦片的规则网格与层级结构把坐标关联搜索限制在靠近输入点的少量瓦片上。根据 LOKI 架构文档LOKI 只关心最详细的层级因为它拥有图中所有边并利用每个瓦片内 5x5 的边索引分箱bins实现“按距离最近优先”的迭代搜索——实测文档数据中位耗时从初版的 130ms纽约降到 4ms纽约而全球瓦片集的数据体积增幅小于 5%。取走你的路线TYR为移动端与离线场景而生的服务层TYR 是 Valhalla 的服务层接收地点与选项作为输入返回路线与机动操作maneuvers作为输出本质上将 Valhalla 组织下的所有其他项目串联起来。TYR 是 Take Your Route取走你的路线的回文缩写对应北欧神话中战神提尔之名。TYR 最初定位为路由服务用户可以借此为移动端或 Web 端生成路线。官方规划的扩展方向包括提供下载瓦片路由数据的方法支持无连接、客户端侧的离线路由用户在路上“取走你的路线”Take Your Route或为某一区域下载图瓦片在没有网络连接的地方继续使用设备客户端侧“返回路线”return to route与离线路由等功能均因此成为可能。从实现角度看TYR 的核心职责是数据编组data marshalling、HTTP、请求解析、响应序列化与进程间通信。仓库中的对应实现包括 src/tyr/actor.cc 与 src/valhalla_service.cc而序列化层则体现在 route_serializer_valhalla.cc、route_serializer_osrm.ccOSRM 兼容输出等文件中。灵活性与可扩展性动态成本与可定制叙事Valhalla 鼓励社区贡献各自国家和地区的专业知识与本地知识。其核心支撑点是动态成本dynamic costing。一个地区的好路线在另一地区未必成立因此可动态、可扩展的“插件式”成本/权重代码具有重要意义。动态成本还带来两个实际收益运行时生成替代路线——无需生成不同数据集即可在运行期为同一请求产出备选路径支持专业化场景的新成本方法——例如卡车路由、绿色/环保路由以及未来可能的低成本least cost路由。在 SIF 架构文档 中SIF 被描述为“为边以及边之间的转换转弯成本提供动态、可扩展的计费”其主要用途是在路由引擎 THOR 形成最优路径时发挥作用。仓库中 src/sif/dynamiccost.cc 与 src/sif/recost.cc 进一步体现了运行时重新计费的机制而各出行方式的成本参数则在 proto/options.proto 中定义如costing、costing_options等字段供请求时动态指定。在叙事与引导生成方面Valhalla 同样希望提供添加自定义叙事短语的途径以及扩展或添加自定义插件的其他方式以便按用户需求定制输出。开放方向与改进叙事ODIN把路径变成能听懂的方向一条高质量的路线结果远不止一条路径形状和“左转/右转/继续直行”的简单列表。ODINOpen Directions and Improved Narrative负责将路径信息转换为易于理解、实用、能在旅途中真正帮助用户的引导与叙事方向。高速公路的出口信息与方向信息将帮助消除沿途关键决策点的歧义。例如从51B出口靠右驶入I 81 North前往I 78/Hazleton/Allentown。ODIN 使用常见基础路名合并机动操作collapse maneuvers并简化复杂交叉路口的转换地标landmarks及其他相关信息也在规划之中。由于引导与路线说明必须能适配不同语言和不同使用场景可扩展性与社区贡献是这一模块的关键。根据 ODIN 架构文档ODIN 包含一组数据结构和算法负责机动操作生成、路名匹配与叙事生成。仓库中的对应实现包括 maneuversbuilder.cc、narrativebuilder.cc 与 directionsbuilder.cc多语言文案资源位于 locales 目录如 en-US.json、de-DE.json而发音与路名格式化逻辑则见 verbal_text_formatter.cc。从体验者到构建者下一步可以做什么入门文档之后你可以沿着以下路径继续深入阅读架构文档了解 LOKI定位、THOR路由、SIF成本、BALDR瓦片数据、ODIN导航、TYR服务 以及地理/数学基础库 MIDGARD 和海拔数据模块 SKADI 的完整分工查看构建工具仓库 scripts 目录提供了 valhalla_build_config 等配置生成脚本src/mjolnir 下则有 valhalla_build_tiles.cc、valhalla_build_admins.cc 等瓦片构建命令行工具体验测试test 目录包含大量可运行的单元测试与 gurka 集成测试框架可用于验证路由、成本与叙事行为了解 API访问 docs/docs/api 下的 API 文档含 JSON 示例与参数定义掌握 route、matrix、isochrone、trace 等端点的请求格式。概括而言Valhalla 的入门价值在于它把“高质量的路线”拆解为可独立演进的数据层BALDR、定位层LOKI、成本层SIF、算法层THOR、叙事层ODIN与服务层TYR并通过动态成本与插件机制让社区能够在共享同一份全球瓦片数据的前提下按地区、按场景定制属于自己的路由体验。赞分享后端【免费下载链接】valhallaOpen Source Routing Engine for OpenStreetMap项目地址https://gitcode.com/gh_mirrors/va/valhalla点击查看免费下载相关推荐电子课本PDF批量下载3步攒齐一学期教材电子课本PDF批量下载3步攒齐一学期教材 跑完之后你选定的文件夹里已经躺着一批以教材名称命名的课本 PDF部分教材的朗读音频还整整齐齐地放在子目录里。干这后端Valhalla入门指南开源路由引擎的完整介绍Valhalla是一款功能强大的开源路由引擎专门用于处理开放地图数据提供完整的地理路由和路径规划解决方案。这个高性能路由引擎支持多种交通模式包括汽车、自行后端从汇编翻回可读 C 代码LLM4Decompile 反编译实战解析从汇编翻回可读 C 代码LLM4Decompile 反编译实战解析 LLM4Decompile 用大语言模型做反编译把 Linux x86_64 二进制里的后端上一篇从构建到性能剖析Ceph Crimson 开发者实战指南下一篇Table Transformer项目实战表格检测与结构识别全流程指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考