REST Resource: providers.trips

리소스: 경로

경로 메타데이터입니다.

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가 마지막으로 수정된 시간을 나타냅니다. intermediateDestinations가 변경되지 않도록 intermediateDestinationIndex 업데이트 시 서버에서 이 값을 캐시하고 UpdateTripRequest에 전달해야 합니다.

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)

출력 전용입니다. 남은 Waypoint의 첫 번째 진입 지점으로 가는 이 이동의 예상 경로입니다. 첫 번째 경유지는 다른 이동에 속할 수 있습니다.
currentRouteSegment

string

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

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용합니다. 디코딩은 아직 지원되지 않습니다.
currentRouteSegmentVersion

string (Timestamp format)

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

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용합니다.

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

object (ConsumableTrafficPolyline)

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

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용합니다.
currentRouteSegmentTrafficVersion

string (Timestamp format)

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

참고: 이 필드는 Driver SDK 및 Consumer 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

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