Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

enum (RouteLabel)

Route 的标签，可用于识别路线要与其他属性进行比较。

object (RouteLeg)

构成路线的一段路程（航点之间的路径段）集合。每段路程均对应于两个非 via Waypoints 之间的行程。例如，没有中间航点的路线只有一段路程。含一个非 via 中间航点的路线有两段路。含一个 via 中间航点的路线有一段路程。路程顺序与从 origin 到 intermediates 到 destination 的航点顺序一致。

integer

路线的行程距离（以米为单位）。

string (Duration format)

浏览路线所需的时长。如果您将 routingPreference 设置为 TRAFFIC_UNAWARE，则此值与 staticDuration 相同。如果您将 routingPreference 设为 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL，则系统会在考虑流量条件的情况下计算此值。

以秒为单位表示的时长，最多包含九个小数位，以“s”结尾。示例："3.5s"。

string (Duration format)

路线的行程时长，而不考虑路况。

以秒为单位表示的时长，最多包含九个小数位，以“s”结尾。示例："3.5s"。

object (Polyline)

整体路线多段线。此多段线是所有 legs 的组合多段线。

string

路线的说明。

string

显示路线时显示的警告数组。

object (Viewport)

多段线的视口边界框。

object (RouteTravelAdvisory)

有关路线的其他信息。

integer

如果您将 optimizeWaypointOrder 设为 true，此字段将包含中间航点的优化顺序。否则，此字段为空。例如，如果您提供出发地：LA；中间航点：达拉斯、班戈、菲尼克斯；目的地：纽约；优化的中间航点顺序为菲尼克斯、达拉斯、班戈，则此字段包含值 [2, 0, 1]。对于输入中提供的第一个中间航点，索引从 0 开始。

object (RouteLocalizedValues)

Route 的属性的文本表示形式。

string

可传递到 Navigation SDK 的 base-44 编码网络令牌，允许 Navigation SDK 在导航期间重建路线，并在重新规划路线时调用 v2.computeRoutes，以遵循您最初创建路线时的意图。客户应将此令牌视为不透明 blob。它不适用于读取或更改。注意：Route.route_token 仅适用于将 ComputeRoutesRequest.routing_preference 设置为 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的请求。包含航点的请求不支持 Route.route_token。

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

integer

路线路程的行程距离（以米为单位）。

string (Duration format)

浏览腿部所需的时间。如果 route_preference 设为 TRAFFIC_UNAWARE，此值与 staticDuration 相同。如果 route_preference 为 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL，在计算此值时会考虑路况信息。

以秒为单位表示的时长，最多包含九个小数位，以“s”结尾。示例："3.5s"。

string (Duration format)

一段路程的持续时间，计算时不会考虑路况条件。

以秒为单位表示的时长，最多包含九个小数位，以“s”结尾。示例："3.5s"。

object (Polyline)

此路程的整体多段线，包括每个 step 的多段线。

object (Location)

这段路程的起始位置。此位置可能与提供的 origin 不同。例如，如果提供的 origin 不在道路附近，这就是道路上的一个点。

object (Location)

这段路程的结束位置。此位置可能与提供的 destination 不同。例如，如果提供的 destination 不在道路附近，这就是道路上的一个点。

object (RouteLegStep)

表示此路程段内的路段的步骤数组。每个步骤代表一项导航指令。

object (RouteLegTravelAdvisory)

包含应告知路由的其他信息，例如可能的路况限制。

object (RouteLegLocalizedValues)

RouteLeg 的属性的文本表示形式。

object (StepsOverview)

有关此 RouteLeg 中步骤的概览信息。此字段仅适用于 TRANSIT 路由。

{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}

string

使用多段线编码算法对多段线进行字符串编码

object (Struct format)

使用 GeoJSON LineString 格式指定多段线

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

integer

此路段的行程距离（以米为单位）。在某些情况下，此字段可能没有值。

string (Duration format)

该路段的行程时长，而不考虑路况。在某些情况下，此字段可能没有值。

以秒为单位表示的时长，最多包含九个小数位，以“s”结尾。示例："3.5s"。

object (Polyline)

与此步骤相关的多段线。

object (Location)

此步骤的起始位置。

object (Location)

此步骤的结束位置。

object (NavigationInstruction)

导航说明。

object (RouteLegStepTravelAdvisory)

包含应让用户知道的其他信息，例如可能在路段上经过的路况限制。

object (RouteLegStepLocalizedValues)

RouteLegStep 的属性的文本表示形式。

object (RouteLegStepTransitDetails)

在出行方式为 TRANSIT 的情况下，与此步骤相关的详细信息。

enum (RouteTravelMode)

用于此步骤的出行方式。

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum (Maneuver)

封装当前步骤的导航说明（例如，左转、合并、直线等）。此字段用于确定要显示的图标。

string

浏览此导航的说明。

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (SpeedReadingInterval)

注意：此字段目前没有填充。

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

以文本形式表示的旅行距离。

object (LocalizedText)

不考虑路况信息的时长，以文本形式表示。

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object (TransitStopDetails)

相应路段的到达和出发站信息。

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails 的属性的文本表示形式。

string

指定该线路在车辆或出发站上行驶的方向。前往终点通常是终点站。

string (Duration format)

将预计时间设为目前同一车站各次发车之间的间隔时长。例如，如果行驶间隔为 600 秒，那么如果您错过了一班公交，那么预计需要 10 分钟才能等到下一班。

以秒为单位表示的时长，最多包含九个小数位，以“s”结尾。示例："3.5s"。

object (TransitLine)

关于此步骤中使用的公交线路的信息。

integer

从出发到到达的经停次数。此计数包含到达站，但不含出发站。例如，如果您的路线从 A 站出发，途经 B 站和 C 站，最终到达 D 站，则 stopCount 将返回 3。

string

时刻表和登机牌上显示的文字，用于标识乘客的公交行程。文字应在服务期内唯一标识行程。例如，“538”是 Amtrak 列车的 tripShortText（在工作日的 15:10 从 CA 前往加利福尼亚州 Sacramento）。

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object (TransitStop)

相应路段的到达站点的相关信息。

string (Timestamp format)

该路段预计到达时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，分辨率为纳秒，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TransitStop)

相应路段的出发站信息。

string (Timestamp format)

相应路段的预计出发时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，分辨率为纳秒，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

公交站的名称。

object (Location)

经停点（以纬度/经度坐标表示）。

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object (LocalizedTime)

采用相应文本表示法表示的时间（包含相应的时区）。

object (LocalizedTime)

采用相应文本表示法表示的时间（包含相应的时区）。

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object (LocalizedText)

以字符串形式指定的时间。

string

包含时区。该值就是 IANA 时区数据库中定义的时区的名称，例如“America/New_York”。

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object (TransitAgency)

此公交线路运营的公交公司。

string

此公交线路的全名，例如“长安路 8 号”。

string

由公交公司提供的该公交线路的 URI。

string

此线路站牌常用的颜色。以十六进制表示。

string

与此线路相关联的图标的 URI。

string

此公交线路的简称。该名称通常是线路编号，例如“M7”或“355”。

string

此线路标识牌上常用的文字颜色。以十六进制表示。

object (TransitVehicle)

此公交线路运营的交通工具类型。

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

此公交公司的名称。

string

公交公司的语言区域专用电话号码。

string

公交公司的 URI。

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object (LocalizedText)

此车辆的名称（首字母大写）。

enum (TransitVehicleType)

所用交通工具的类型。

string

与此车辆类型相关联的图标的 URI。

string

根据当地交通标识牌，与该交通工具类型相关联的图标的 URI。

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (TollInfo)

包含特定RouteLeg的收费信息。仅当我们预计 RouteLeg 上有收费站时，才会填充此字段。如果已设置此字段，但未填充估算价格子字段，则预计道路会避开收费站，但不知道估算价格。如果此字段不存在，则 RouteLeg 没有收费。

object (SpeedReadingInterval)

详细介绍流量密度的速度读取间隔。适用于 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 路由偏好设置。这些间隔涵盖 RouteLeg 的整个多段线，且没有重叠。指定间隔的起点与前一个时间段的端点相同。

例如：

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

以文本形式表示的旅行距离。

object (LocalizedText)

考虑流量条件的时长（以文本形式表示）。注意：如果您未请求流量信息，此值将与 staticDuration 的值相同。

object (LocalizedText)

不考虑路况信息的时长，以文本形式表示。

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object (MultiModalSegment)

总结了 RouteLeg.steps 的不同多模态细分的相关信息。如果 RouteLeg 的步骤中不包含任何多模态细分，则不会填充此字段。

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object (NavigationInstruction)

多模态细分的 NavigationInstruction。

enum (RouteTravelMode)

多模式车段的出行方式。

integer

对应的多模态分段起点所对应的 RouteLegStep 索引。

integer

对应的 RouteLegStep 索引，即多模态段的末尾。

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

必需。视口的低点。

object (LatLng)

必需。视口的高点。

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object (LocalizedText)

以文本形式表示的旅行距离。

object (LocalizedText)

考虑流量条件的持续时间，以文本形式表示。注意：如果您未请求流量信息，此值将与 staticDuration 的值相同。

object (LocalizedText)

不考虑路况信息的时长，以文本形式表示。

object (LocalizedText)

公交价格以文本形式表示。

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object (GeocodedWaypoint)

经过地理编码的航点。

object (GeocodedWaypoint)

目的地经过地理编码的航点。

object (GeocodedWaypoint)

一个经过地理编码的中间航点列表，其中每个航点都有一个索引字段，对应按照航点指定的请求顺序（从零开始）。

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object (Status)

表示地理编码操作生成的状态代码。

string

结果的类型，采用零个或多个类型标记的形式。支持的类型：https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types

boolean

表示地理编码器无法返回与原始请求完全匹配的结果，但能够匹配所请求地址的一部分。您不妨检查一下原始请求中是否有拼写错误和/或地址不完整的情况。

string

此结果的地点 ID。

integer

请求中相应中间航点的索引。仅当相应的航点是中间航点时填充。