RouteMatrixElement

封装 ComputeRouteMatrix API 中为起点/终点对计算的路线信息。此 proto 可以流式传输到客户端。

JSON 表示法
{
  "originIndex": integer,
  "destinationIndex": integer,
  "status": {
    object (Status)
  },
  "condition": enum (RouteMatrixElementCondition),
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "fallbackInfo": {
    object (FallbackInfo)
  }
}
字段
originIndex

integer

请求中来源的索引(从零开始)。

destinationIndex

integer

请求中目的地的索引(从零开始)。

status

object (Status)

此元素的错误状态代码。

condition

enum (RouteMatrixElementCondition)

指示是否找到该路由。与状态无关。

distanceMeters

integer

路线的行程距离(以米为单位)。

duration

string (Duration format)

导航路线所需的时长。如果您将 routingPreference 设为 TRAFFIC_UNAWARE,则此值与 staticDuration 相同。如果您将 routingPreference 设置为 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL,则系统会在计算此值时考虑交通状况。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

staticDuration

string (Duration format)

在不考虑路况信息的情况下通过路线的时长。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

travelAdvisory

object (RouteTravelAdvisory)

有关该路线的其他信息。例如:限制信息和过路费信息

fallbackInfo

object (FallbackInfo)

在某些情况下,如果服务器无法根据给定偏好设置为此特定始发地/目的地对计算路线,则可能会改用其他计算模式。使用回退模式时,此字段包含有关回退响应的详细信息。否则,此字段将处于未设置状态。

状态

Status 类型定义了适用于不同编程环境(包括 REST API 和 RPC API)的逻辑错误模型。此类型供 gRPC 使用。每条 Status 消息包含三部分数据:错误代码、错误消息和错误详细信息。

如需详细了解该错误模型及其使用方法,请参阅 API 设计指南

JSON 表示法
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
字段
code

integer

状态代码,应为 google.rpc.Code 的枚举值。

message

string

面向开发者的错误消息(应采用英语)。任何向用户显示的错误消息都应进行本地化并通过 google.rpc.Status.details 字段发送,或者由客户端进行本地化。

details[]

object

包含错误详细信息的消息列表。有一组通用的消息类型可供 API 使用。

可以包含任意类型字段的对象。附加字段 "@type" 包含用于标示相应类型的 URI。示例:{ "id": 1234, "@type": "types.example.com/standard/id" }