Routes Preferred API 目前仅适用于部分客户。如需了解详情,请
与销售人员联系。
ComputeRoutesRequest
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
JSON 表示法 |
{
"origin": {
object (Waypoint )
},
"destination": {
object (Waypoint )
},
"intermediates": [
{
object (Waypoint )
}
],
"travelMode": enum (RouteTravelMode ),
"routingPreference": enum (RoutingPreference ),
"polylineQuality": enum (PolylineQuality ),
"polylineEncoding": enum (PolylineEncoding ),
"departureTime": string,
"computeAlternativeRoutes": boolean,
"routeModifiers": {
object (RouteModifiers )
},
"languageCode": string,
"units": enum (Units ),
"optimizeWaypointOrder": boolean
} |
字段 |
origin |
object (Waypoint )
必需。起点航点。
|
destination |
object (Waypoint )
必需。目的地航点。
|
intermediates[] |
object (Waypoint )
可选。路线上(不包括终点)的一组航点,用于停靠或经过。最多支持 25 个中间航点。
|
travelMode |
enum (RouteTravelMode )
可选。指定交通方式。
|
routingPreference |
enum (RoutingPreference )
可选。指定如何计算路线。服务器会尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长,则返回错误。只有当 travelMode 为 DRIVE 或 TWO_WHEELER 时,您才能指定此选项,否则请求会失败。
|
polylineQuality |
enum (PolylineQuality )
可选。指定多段线的质量偏好设置。
|
polylineEncoding |
enum (PolylineEncoding )
可选。指定多段线的首选编码。
|
departureTime |
string (Timestamp format)
可选。出发时间。如果您未设置此值,则此值默认为您发出请求的时间。如果将此值设置为已经发生的时间,则请求将失败。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z" 。
|
computeAlternativeRoutes |
boolean
可选。指定除了路线之外,是否计算备选路线。对于包含中间航点的请求,系统不会返回备选路线。
|
routeModifiers |
object (RouteModifiers )
可选。一组要满足的条件,这些条件会影响路线的计算方式。
|
languageCode |
string
可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 Unicode 语言区域标识符。如需查看支持的语言列表,请参阅语言支持。如果您未提供此值,系统会根据路线请求的位置推断出显示语言。
|
units |
enum (Units )
可选。指定显示字段的衡量单位。这包括 NavigationInstruction 中的 instruction 字段。路线、路段、步数距离和时长所用的衡量单位不受此值的影响。如果您未提供此值,系统会根据请求的位置推断出显示单位。
|
optimizeWaypointOrder |
boolean
如果将 optimizeWaypointOrder 设置为 true,系统会尝试重新排列指定的中间航点,以最大限度地降低路线的总体费用。如果任何中间航点是通过航点,则请求会失败。使用 ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index 查找新排序。如果 X-Goog-FieldMask 标头中没有请求 routes.optimized_intermediate_waypoint_index ,请求将失败。如果 optimizeWaypointOrder 设为 false,ComputeRoutesResponse.optimized_intermediate_waypoint_index 为空。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[[["\u003cp\u003eThe \u003ccode\u003eComputeRoutes\u003c/code\u003e request message defines the parameters for calculating routes between an origin and a destination, potentially including intermediate waypoints.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize route calculations by specifying travel mode, routing preferences, departure time, and whether to compute alternative routes.\u003c/p\u003e\n"],["\u003cp\u003eThe request allows for tailoring the response by choosing polyline quality and encoding, language, units of measure, and waypoint optimization.\u003c/p\u003e\n"],["\u003cp\u003eFields such as \u003ccode\u003eorigin\u003c/code\u003e, \u003ccode\u003edestination\u003c/code\u003e are required while others like \u003ccode\u003eintermediates\u003c/code\u003e, \u003ccode\u003etravelMode\u003c/code\u003e, \u003ccode\u003eroutingPreference\u003c/code\u003e are optional and offer flexibility in route planning.\u003c/p\u003e\n"],["\u003cp\u003eThe response to a \u003ccode\u003eComputeRoutes\u003c/code\u003e request provides detailed route information including optimized waypoint order, if requested, and various display options.\u003c/p\u003e\n"]]],["The `ComputeRoutes` request defines a route calculation. Key actions include specifying `origin` and `destination` waypoints, with optional `intermediates`. The request can set `travelMode`, `routingPreference`, and `polylineQuality`. Users can define `departureTime`, request `computeAlternativeRoutes`, and use `routeModifiers`. Other settings are available, such as `languageCode`, display `units`, `polylineEncoding`. Finally, it permits `optimizeWaypointOrder` to rearrange `intermediate` waypoints.\n"],null,[]]