HERE Maps Map matching API TracePoints参数文档及服务状态咨询

1. 接口及返回字段的废弃、服务存续说明 #

你当前使用的m.fleet.ls.hereapi.com/2/matchroute.json是HERE平台的遗留版（Legacy）车队远程信息处理轨迹匹配接口：

• 该v2版本接口目前没有公布明确的停止服务时间表，但官方已经停止对该版本的功能更新，仅做基础可用性维护，长期来看会逐步引导存量用户迁移到新版Map Matching服务。
• 你列出的这些返回字段本身是该旧版接口的原生返回字段，不存在“字段单独废弃”的情况，只要该旧接口还在对外提供服务，这些字段就会正常返回，不会在服务运行期间单独下线。

2. 参数官方说明文档的获取渠道 #

旧版接口的公开文档已经从官方公开文档站下线，你可以通过以下正规渠道获取准确的官方释义：

• 若你是HERE付费商业用户，直接对接你的专属技术支持/客户成功对接人，提供你正在使用该接口做生产业务的凭证、以及需要查询的字段列表，对方会提供该遗留版本接口的完整内部说明文档。
• 通过HERE官方开发者平台的支持工单通道提交咨询，明确说明你当前的存量业务正在使用该v2版本matchroute接口，需要对应返回字段的官方解释，工单渠道会给你反馈准确的字段说明。
• 你列的字段语义和新版HERE Map Matching接口的TracePoint类返回字段高度对齐，在拿到官方文档前，你可以参考核心字段的通用释义做业务开发：
  • lat/lon：轨迹点匹配到道路上的位置经纬度
  • document.2..TracePoints.confidenceValue：当前点匹配结果的置信度，取值范围0-1，数值越高代表匹配结果的可靠性越高
  • document.2..TracePoints.matchDistance：原始输入的GPS点到最终匹配道路位置的垂直距离
  • document.2..TracePoints.minError：本次匹配计算的最小误差阈值
  • document.2..TracePoints.linkIdMatched：当前点匹配到的道路Link的唯一ID
  • document.2..TracePoints.routeLinkSeqNrMatched：匹配到的道路Link在整条匹配路径中的顺序编号
  • document.2..TracePoints.matchOffsetOnLink：匹配点在对应道路Link上的位置偏移量
  • document.2..TracePoints.linkIdMatched.1：当前点存在次优匹配结果时，返回的备选道路Link ID

注意：非官方渠道拿到的旧版零散文档可能存在版本偏差，生产环境使用建议以HERE官方支持渠道给出的说明为准。

内容的提问来源于stack exchange，提问作者Andreas