REST Resource: providers.trips

리소스: Trip

경로 메타데이터입니다.

JSON 표현 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
필드
name

string

출력 전용입니다. 'providers/{provider}/trips/{trip} 형식입니다.
vehicleId

string

이 이동을 수행하는 차량의 ID입니다.
tripStatus

enum (TripStatus)

이동의 현재 상태입니다.
tripType

enum (TripType)

이동 유형입니다.
pickupPoint

object (TerminalLocation)

고객이 수령할 위치입니다.
actualPickupPoint

object (StopLocation)

입력 전용입니다. 고객이 픽업된 실제 위치 및 시간입니다. 이 입력란은 실제 수령 정보에 관한 의견을 제공하기 위한 제공자용 입력란입니다.
actualPickupArrivalPoint

object (StopLocation)

입력 전용입니다. 운전자가 승차 지점에 도착한 실제 시간 및 위치입니다. 이 입력란은 제공업체가 수령 지점의 실제 도착 정보에 관한 의견을 제공하는 용도입니다.
pickupTime

string (Timestamp format)

출력 전용입니다. 승객이 픽업될 것으로 예상되는 미래 시간 또는 실제로 픽업된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
intermediateDestinations[]

object (TerminalLocation)

이동에서 요청한 중간 정류장입니다 (승차 및 하차 외에도). 처음에는 공유 경로에는 이 기능이 지원되지 않습니다.
intermediateDestinationsVersion

string (Timestamp format)

intermediateDestinations가 마지막으로 수정된 시간을 나타냅니다. 서버는 이 값을 캐시하고 intermediateDestinationIndex를 업데이트할 때 UpdateTripRequest에 전달하여 intermediateDestinations가 변경되지 않도록 해야 합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
intermediateDestinationIndex

integer

TripStatus이 ENROUTE_TO_INTERMEDIATE_DESTINATION인 경우 차량이 다음에 교차할 중간 목적지를 나타내는 [0..N-1] 사이의 숫자입니다. TripStatus이 ARRIVED_AT_INTERMEDIATE_DESTINATION인 경우 차량이 어느 중간 목적지에 있는지 나타내는 [0..N-1] 사이의 숫자입니다. 이 값은 제공업체가 설정합니다. intermediateDestinations가 없으면 이 필드는 무시됩니다.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

입력 전용입니다. 운전자가 중간 목적지에 도착한 실제 시간과 위치입니다. 이 필드는 제공업체가 중간 목적지의 실제 도착 정보에 관한 피드백을 제공하는 데 사용됩니다.
actualIntermediateDestinations[]

object (StopLocation)

입력 전용입니다. 중간 목적지에서 고객이 승차한 실제 시간과 위치입니다. 제공업체가 중간 목적지에서의 실제 승차 정보에 관한 의견을 제공하는 필드입니다.
dropoffPoint

object (TerminalLocation)

고객이 하차할 위치를 표시한 위치입니다.
actualDropoffPoint

object (StopLocation)

입력 전용입니다. 고객이 하차한 실제 시간 및 위치입니다. 이 필드는 제공업체가 실제 하차 정보에 관한 의견을 제공하는 데 사용됩니다.
dropoffTime

string (Timestamp format)

출력 전용입니다. 승객이 최종 목적지에 도착할 것으로 예상되는 미래 시간 또는 승객이 실제로 도착한 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
remainingWaypoints[]

object (TripWaypoint)

출력 전용입니다. 현재 위치에서 하차 지점까지의 전체 경로입니다(해당 위치 포함). 이 경로에는 다른 경로의 경유지가 포함될 수 있습니다.
vehicleWaypoints[]

object (TripWaypoint)

이 필드는 이동에 대한 경유지의 수동 순서를 지원합니다. 여기에는 할당된 차량의 나머지 모든 경유지와 이 경로의 픽업 및 하차 경유지가 포함됩니다. 이동이 차량에 할당되지 않은 경우 Fleet Engine은 이 필드를 무시합니다. 개인 정보 보호를 위해 이 필드는 trips.update 및 trips.create 호출 시에만 서버에 의해 채워지며 trips.get 호출 시에는 채워지지 않습니다.
route[]

object (LatLng)

출력 전용입니다. remainingWaypoints의 첫 번째 항목까지의 예상 경로입니다. 첫 번째 웨이포인트는 다른 경로에 속할 수 있습니다.
currentRouteSegment

string

출력 전용입니다. 다음 경유지에 대한 인코딩된 경로입니다.

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다.
currentRouteSegmentVersion

string (Timestamp format)

출력 전용입니다. 경로가 마지막으로 수정된 시간을 나타냅니다.

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

출력 전용입니다. currentRouteSegment의 교통상황을 사용할 수 있는 경우 이를 나타냅니다.

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다.
currentRouteSegmentTrafficVersion

string (Timestamp format)

출력 전용입니다. currentRouteSegmentTraffic가 마지막으로 수정된 시간을 나타냅니다.

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
currentRouteSegmentEndPoint

object (TripWaypoint)

출력 전용입니다. currentRouteSegment이(가) 끝나는 경유지입니다.
remainingDistanceMeters

integer

출력 전용입니다. currentRouteSegment 필드의 남은 운전 거리입니다. 이동이 차량에 할당되지 않았거나 이동이 완료 또는 취소된 경우 값이 지정되지 않습니다.
etaToFirstWaypoint

string (Timestamp format)

출력 전용입니다. 다음 경유지까지의 도착예정시간 (remainingWaypoints 입력란의 첫 번째 항목)입니다. 이동이 차량에 할당되지 않았거나 이동이 비활성 (완료 또는 취소됨) 상태인 경우 값이 지정되지 않습니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
remainingTimeToFirstWaypoint

string (Duration format)

출력 전용입니다. 경로 데이터가 반환된 시점부터 Trip.eta_to_first_waypoint의 시간까지의 시간입니다. 이동이 차량에 할당되지 않았거나 이동이 비활성 (완료 또는 취소됨) 상태인 경우 값이 지정되지 않습니다.

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

string (Timestamp format)

출력 전용입니다. remainingWaypoints가 마지막으로 변경된 시간(중간 지점이 추가, 삭제 또는 변경됨)을 나타냅니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
remainingWaypointsRouteVersion

string (Timestamp format)

출력 전용입니다. remainingWaypoints.path_to_waypoint 및 remainingWaypoints.traffic_to_waypoint가 마지막으로 수정된 시간을 나타냅니다. 클라이언트 앱은 이 값을 캐시하고 GetTripRequest에 전달하여 remainingWaypoints의 경로와 트래픽이 업데이트된 경우에만 반환되도록 해야 합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
numberOfPassengers

integer

변경할 수 없습니다. 이 경로의 승객 수를 나타내며 운전자는 포함되지 않습니다. 차량에 vehicles.search 응답에 반환될 수 있는 수용 인원이 있어야 합니다.
lastLocation

object (VehicleLocation)

출력 전용입니다. 경로를 따라 차량의 마지막으로 보고된 위치를 나타냅니다.
lastLocationSnappable

boolean

출력 전용입니다. 차량의 lastLocation를 currentRouteSegment에 스냅할 수 있는지 나타냅니다. lastLocation 또는 currentRouteSegment가 없으면 false입니다. Fleet Engine에서 계산됩니다. 클라이언트의 모든 업데이트는 무시됩니다.
view

enum (TripView)

채워지는 여행 필드의 하위 집합 및 해석 방법입니다.

TripStatus

이동의 진행 상황을 나타내는 이동 상태입니다.

열거형
UNKNOWN_TRIP_STATUS 지정되지 않았거나 인식되지 않은 이동 상태에 사용되는 기본값입니다.
NEW 새로 생성된 이동입니다.
ENROUTE_TO_PICKUP 운전자가 승차 지점으로 이동 중입니다.
ARRIVED_AT_PICKUP 운전자가 승차 지점에 도착했습니다.
ARRIVED_AT_INTERMEDIATE_DESTINATION 운전자가 중간 목적지에 도착하여 승객을 기다리고 있습니다.
ENROUTE_TO_INTERMEDIATE_DESTINATION 운전자가 하차 지점이 아닌 중간 목적지로 이동 중입니다.
ENROUTE_TO_DROPOFF 운전자가 승객을 태우고 다음 목적지로 이동 중입니다.
COMPLETE 승객이 하차했으며 이동이 완료되었습니다.
CANCELED 운전자, 탑승자 또는 차량 공유 제공업체가 픽업하기 전에 이동이 취소되었습니다.

StopLocation

정류장 (승차/하차)이 발생한 실제 위치입니다.

JSON 표현 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
필드
point

object (LatLng)

필수 항목입니다. 실제 위치를 나타냅니다.
timestamp

string (Timestamp format)

중지가 발생한 시점을 나타냅니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
stopTime
(deprecated)

string (Timestamp format)

입력 전용입니다. 지원 중단되었습니다. 타임스탬프 필드를 사용합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

TripView

trips.get 응답에서 여러 이동 필드 집합의 선택기입니다. 관련 내용은 AIP-157을 참고하세요. 뷰가 추가될 가능성이 높습니다.

열거형
TRIP_VIEW_UNSPECIFIED 기본값입니다. 이전 버전과의 호환성을 위해 API는 기본적으로 SDK 보기로 설정됩니다. 안정성과 지원을 보장하려면 고객이 SDK 이외의 TripView를 선택하는 것이 좋습니다.
SDK 공개적으로 사용 가능한 라이브러리를 사용하여 해석하거나 지원할 수 없는 필드가 포함됩니다.
JOURNEY_SHARING_V1S 이동 공유 사용 사례에 맞게 경로 필드가 채워집니다. 이 뷰는 서버 간 통신을 위해 설계되었습니다.

메서드

create

 Fleet Engine에서 이동을 만들고 새 이동을 반환합니다.

get

 단일 이동에 대한 정보를 가져옵니다.
특정 차량의 모든 이동 경로를 가져옵니다.

update

 경로 데이터를 업데이트합니다.