ComputeRoutesRequest

JSON 表示法

ComputeRoutes 请求消息。

JSON 表示法

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)
    }
  ],
  "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` 为空。