适用于 Automotive 的 Routes API

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

Routes API for Automotive 文档中包含的内容

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

为请求授权

如需授权您向 annotatePaths 发出的请求,您必须使用下述 OAuth 方法:使用 OAuth (Automotive)。此类请求要求您通过 OAuth 使用模拟,与调用 Automotive Maps API 的方式类似(但范围不同)。

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

包含 Standard Routes API 的共享文档

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

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

获取帮助

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

驼峰式大小写规范和术语

该文档主要使用 REST 驼峰式大小写规范(例如 annotatePaths),而不是 RPC 大小写规范 (AnnotatePaths)。但是,这两种大小写形式相同。

此外,虽然 annotatePathscomputeRoutescomputeRoutesMatrix 通常称为“API”,但它们实际上是自定义方法。不过,您可能会看到它们称为方法或 API。

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

本部分介绍了 Routes API for Automotive 中的唯一属性。以下功能已正式发布。

通过 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)。