ComputeRoutesRequest

v1alpha.computeRoutes 请求消息。

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)

可选。指定如何计算路线。服务器会尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长,则返回错误。我们日后可能会实现后备机制,以便在首选选项无法给出有效结果时使用其他选项。只有在 travelModeDRIVETWO_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”。如需了解详情,请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如需查看受支持语言的列表,请参阅语言支持。如果您未提供此值,系统会根据路线请求的位置推断出显示语言。

units

enum (Units)

可选。指定显示字段的测量单位。这包括 NavigationInstruction 中的 instruction 字段。路线、路程、步数、距离和时长所使用的测量单位不受此值的影响。如果您不提供此值,系统会根据请求的位置推断出显示单位。

optimizeWaypointOrder

boolean

如果将 optimizationWaypointOrder 设置为 true,则尝试对指定的中间路标重新排序,以最大程度地降低路线的总体成本。如果任何中间航点为途经航点,请求将失败。使用 ComputeRoutesResponse.Routes.optimize_intermediate_waypoint_index 来查找新排序。如果未在 X-Goog-FieldMask 标头中请求 routes.optimize_intermediate_waypoint_index,则请求会失败。如果将 OptimizationWaypointOrder 设置为 false,则 ComputeRoutesResponse.Optimized_intermediate_waypoint_index 将为空。