Routes Preferred API 目前仅适用于部分客户。如需了解详情,请
与销售人员联系。
配置质量与延迟时间的权衡取舍
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Routes Preferred API 提供三种用于计算路线的路线偏好设置。它们的不同之处在于,在计算路线时考虑交通状况的程度不同。每种路线偏好设置都会生成在路线质量、预计到达时间和响应延迟方面有所不同的结果。
路况信息简介
路况信息用于描述交通流量的速率。例如:
如果没有拥堵,路况会被视为正常,车流会以正常的畅通速度行驶。
临近高峰时段,交通密度增加,导致交通速度减慢,从而形成轻度到中度的交通状况。
在拥堵的交通状况下,流量会降至最低,从而导致交通严重拥堵。
不了解路况
如果您设置了 TRAFFIC_UNAWARE
路线偏好设置,系统在计算路线时不会考虑路况。此路由偏好设置可提供最低的响应延迟时间(最快返回响应)。
如果您希望尽快获得返回的响应,并且近似的路线详情就足够了,请使用此路线偏好设置。
感知路况
设置 TRAFFIC_AWARE
路线偏好设置后,系统会根据路况信息计算路线。因此,路线和路线详情能更准确地反映现实情况。由于数据质量的提高是以牺牲响应延迟时间为代价的,因此我们应用了性能优化来大幅缩短延迟时间。
如果您希望获得更准确的路线详情,但可以接受响应延迟略有增加,请使用此路线偏好设置。
可感知路况的最佳路线
当您设置 TRAFFIC_AWARE_OPTIMAL
路线偏好设置时,系统会根据路况信息计算路线,但不会应用任何性能优化。在此模式下,服务器会更全面地搜索道路网络,以找到最佳路线。
此路由偏好设置会带来最长的响应延迟时间(即,响应返回的延迟时间最长)。如果您希望获得最高质量的结果,而不考虑响应时间,请使用此路由偏好设置。
示例
以下 JSON 代码演示了如何在请求消息实体正文中设置路由偏好设置。
{
"origin":{
"location":{
"latLng":{
"latitude":37.419734,
"longitude":-122.0827784
}
}
},
"destination":{
"location":{
"latLng":{
"latitude":37.417670,
"longitude":-122.079595
}
}
},
"travelMode":"DRIVE",
"routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-09-26。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-26。"],[],["The Routes Preferred API offers three routing preferences: `TRAFFIC_UNAWARE`, `TRAFFIC_AWARE`, and `TRAFFIC_AWARE_OPTIMAL`. `TRAFFIC_UNAWARE` ignores traffic, providing the fastest response. `TRAFFIC_AWARE` considers traffic, balancing accuracy with moderate latency. `TRAFFIC_AWARE_OPTIMAL` exhaustively searches for the best route accounting for traffic, resulting in the highest quality but with the longest latency. The API allows setting these preferences in requests, for example using JSON. Traffic conditions are classified as normal, light to moderate, or heavy.\n"]]