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):2024-11-11。
[null,null,["最后更新时间 (UTC):2024-11-11。"],[[["The `ComputeRoutes` request message defines the parameters for calculating routes between an origin and a destination, potentially including intermediate waypoints."],["You can customize route calculations by specifying travel mode, routing preferences, departure time, and whether to compute alternative routes."],["The request allows for tailoring the response by choosing polyline quality and encoding, language, units of measure, and waypoint optimization."],["Fields such as `origin`, `destination` are required while others like `intermediates`, `travelMode`, `routingPreference` are optional and offer flexibility in route planning."],["The response to a `ComputeRoutes` request provides detailed route information including optimized waypoint order, if requested, and various display options."]]],[]]