Routes API for Automotive 为开发车内导航功能的汽车合作伙伴提供专门的属性。它利用针对汽车行业定制的属性扩展了标准 Routes API。
Routes API for Automotive 文档中包含的内容
除了标准 Routes API 的文档之外,Routes API for Automotive 还包含以下内容:
为请求授权
如需授权您向 annotatePaths
发出的请求,您必须使用下述 OAuth 方法:使用 OAuth (Automotive)。此类请求要求您通过 OAuth 使用模拟,与调用 Automotive Maps API 的方式类似(但范围不同)。
但是,如果您要调用 computeRoutes
或 computeRoutesMatrix
方法,则可以使用常规 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
)。但是,这两种大小写形式相同。
此外,虽然 annotatePaths
、computeRoutes
或 computeRoutesMatrix
通常称为“API”,但它们实际上是自定义方法。不过,您可能会看到它们称为方法或 API。
正式版(正式版)和实验性功能
本部分介绍了 Routes API for Automotive 中的唯一属性。以下功能已正式发布。
通过 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
)。