Routes Preferred API 目前仅适用于部分客户。如需了解详情,请
与销售人员联系。
Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。
配置质量与延迟时间的权衡取舍
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
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):2026-10-25。
[[["易于理解","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):2026-10-25。"],[],["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"]]