RouteMatrixElement

v1alpha.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

요청에 있는 출처의 0부터 시작하는 색인입니다.
destinationIndex

integer

요청에 있는 대상의 0부터 시작하는 색인입니다.
status

object (Status)

이 요소의 오류 상태 코드입니다.
condition

enum (RouteMatrixElementCondition)

경로를 찾았는지 여부를 나타냅니다. 상태와 무관합니다.
distanceMeters

integer

경로의 이동 거리(미터)입니다.
duration

string (Duration format)

경로를 탐색하는 데 필요한 시간입니다. routingPreference을 TRAFFIC_UNAWARE로 설정하면 이 값은 staticDuration와 동일합니다. routingPreference을 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정하면 이 값은 교통상황을 고려하여 계산됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
staticDuration

string (Duration format)

교통상황을 고려하지 않고 경로를 통과한 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
travelAdvisory

object (RouteTravelAdvisory)

경로에 대한 추가 정보입니다. 예: 제한정보 및 통행료 정보
fallbackInfo

object (FallbackInfo)

서버에서 이 특정 출발지/목적지 쌍에 대해 지정된 환경설정으로 경로를 계산할 수 없는 경우 다른 계산 모드를 사용하도록 대체할 수 있습니다. 대체 모드가 사용되는 경우 이 필드에는 대체 응답에 대한 자세한 정보가 포함됩니다. 그렇지 않으면 이 필드가 설정되지 않습니다.

상태

Status 유형은 REST API, RPC API를 비롯하여 다양한 프로그래밍 환경에 적합한 논리적 오류 모델을 정의하며, gRPC에서 사용됩니다. 각 Status 메시지에는 오류 코드, 오류 메시지, 오류 세부정보라는 3가지 데이터가 포함됩니다.

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" }