适用于 Automotive 的 Routes API 为开发车内导航功能的汽车合作伙伴提供专用属性。它利用针对汽车行业量身定制的属性扩展了标准 Routes API。
适用于 Automotive 的 Routes API 文档包含哪些内容
除了标准 Routes API 的文档之外,适用于 Automotive 的 Routes API 还包含以下内容:
向请求授权
如需授权您对 annotatePaths
的请求,您必须使用此处所述的 OAuth 方法:使用 OAuth (Automotive)。这些请求要求您通过 OAuth 使用模拟,类似于您调用 Automotive Maps API 的方式(但范围不同)。
但是,如果您调用的是 computeRoutes
或 computeRoutesMatrix
方法,则可以使用常规 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
)。不过,两种大小写形式同样有效。
此外,虽然通常将 annotatePaths
、computeRoutes
或 computeRoutesMatrix
称为“API”,但它们实际上是自定义方法。不过,它们被称为方法或 API。
正式版(正式版)和实验性功能
本部分介绍了适用于 Automotive 的 Routes API 中的独特属性。以下功能已正式发布。
通过 Routes API 公开的基本属性
E7 多段线(以 E7 坐标而不是 E5 坐标描述的标准编码多段线):
实验性功能
以下功能目前处于实验阶段,仅供部分客户使用:
通过 Routes API 公开的基本属性
- 作为可选输入的路由令牌。请参阅
Route
中的routeToken
。
沿多段线可用的信息
- 交通堵塞延迟,以交通分钟数为单位。请参见
IncidentType
。 - 不含文本突发事件详情的突发事件枚举。请参见
IncidentInfo
。
请参见PolylineDetails
。
其他功能
- 路线沿途的海拔高度。请参见
AltitudeInfo
。 - 路线沿途的预测速度分桶(8 个存储分区,每个存储分区宽度 10-20 公里/小时)。请参见
PredictedSpeedInfo
。
路由修饰符
您可以通过该 API 触发以下 RouteModifiers
。不过,这些路线可能不遵循修饰符目标,因为它们仍在开发和测试中。如有疑问,请与您的 Google 代表联系。
- 避免使用穿插广告 (
avoidVignettes[]
)。支持下列六个国家/地区:奥地利、瑞士、匈牙利、斯洛文尼亚、斯洛伐克和捷克。 - 允许多座车辆 (HOV) 的道路 (
hovPreference
)。美国和加拿大支持此功能。 - 避开隧道 (
avoidTunnels
)。 - 拖车专用路线(
totalAxleCount
、totalHeightMm
、totalLengthMm
、totalWidthMm
、totalWeightKg
)。