适用于 Automotive 的 Routes API

适用于 Automotive 的 Routes API 为开发车内导航功能的汽车合作伙伴提供专用属性。它利用针对汽车行业量身定制的属性扩展了标准 Routes API。

适用于 Automotive 的 Routes API 文档包含哪些内容

除了标准 Routes API 的文档之外,适用于 Automotive 的 Routes API 还包含以下内容:

向请求授权

如需授权您对 annotatePaths 的请求,您必须使用此处所述的 OAuth 方法:使用 OAuth (Automotive)。这些请求要求您通过 OAuth 使用模拟,类似于您调用 Automotive Maps API 的方式(但范围不同)。

但是,如果您调用的是 computeRoutescomputeRoutesMatrix 方法,则可以使用常规 Routes API 文档中介绍的任一授权类型:API 密钥OAuth

包含 Standard Routes API 的共享文档

适用于 Automotive 的 Routes API 与标准 Routes API 共享文档,例如“指南”标签页下的教程。

请注意,在使用标准 Routes API 教程时,链接会指向标准参考。您需要转到 Routes API 中的对应链接以获取 Automotive 参考。为此,您可以在浏览器网址的 routes/ 后添加 automotive/,如下所示:routes/automotive/

获取帮助

由于适用于 Automotive 的 Routes API 尚未公开发布,请勿向我们的公开问题跟踪器提交 bug 报告。我们为您的团队提供了一个公司专用的问题跟踪器组件,您可以在其中提交 bug。如果您有其他疑虑,请与您的 Google 联系人联系。

驼峰命名法规范和术语

本文档主要使用 REST 驼峰式大小写规范(例如 annotatePaths),而不是 RPC 大小写规范 (AnnotatePaths)。不过,两种大小写形式同样有效。

此外,虽然通常将 annotatePathscomputeRoutescomputeRoutesMatrix 称为“API”,但它们实际上是自定义方法。不过,它们被称为方法或 API。

正式版(正式版)和实验性功能

本部分介绍了适用于 Automotive 的 Routes API 中的独特属性。以下功能已正式发布。

通过 Routes API 公开的基本属性

E7 多段线(以 E7 坐标而不是 E5 坐标描述的标准编码多段线):

  • 避开轮渡。请参阅 FerryInfo
  • 避开收费站。请参阅 TollInfo
  • [预览] 根据引擎类型选择节能路线。如需了解详情,请参阅选择环保路线

实验性功能

以下功能目前处于实验阶段,仅供部分客户使用:

通过 Routes API 公开的基本属性

  • 作为可选输入的路由令牌。请参阅 Route 中的 routeToken

沿多段线可用的信息

  • 交通堵塞延迟,以交通分钟数为单位。请参见IncidentType
  • 不含文本突发事件详情的突发事件枚举。请参见IncidentInfo

请参见PolylineDetails

其他功能

  • 路线沿途的海拔高度。请参见AltitudeInfo
  • 路线沿途的预测速度分桶(8 个存储分区,每个存储分区宽度 10-20 公里/小时)。请参见PredictedSpeedInfo

路由修饰符

您可以通过该 API 触发以下 RouteModifiers。不过,这些路线可能不遵循修饰符目标,因为它们仍在开发和测试中。如有疑问,请与您的 Google 代表联系。

  • 避免使用穿插广告 (avoidVignettes[])。支持下列六个国家/地区:奥地利、瑞士、匈牙利、斯洛文尼亚、斯洛伐克和捷克。
  • 允许多座车辆 (HOV) 的道路 (hovPreference)。美国和加拿大支持此功能。
  • 避开隧道 (avoidTunnels)。
  • 拖车专用路线(totalAxleCounttotalHeightMmtotalLengthMmtotalWidthMmtotalWeightKg)。