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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
intermediateDestinations[]

object (TerminalLocation)

이동 요청의 순서에 따른 중간 정류장 (픽업 및 하차 외) 처음에는 공유 경로에는 이 기능이 지원되지 않습니다.
intermediateDestinationsVersion

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
remainingWaypoints[]

object (TripWaypoint)

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

object (TripWaypoint)

이 필드는 경로의 경유지를 수동으로 정렬하는 것을 지원합니다. 여기에는 할당된 차량의 나머지 모든 중간 지점과 이 경로의 픽업 및 하차 중간 지점이 포함됩니다. 이동이 차량에 할당되지 않은 경우 Fleet Engine은 이 필드를 무시합니다. 개인 정보 보호를 위해 이 필드는 trips.get 호출이 아닌 trips.update 및 trips.create 호출에서만 서버에 의해 채워집니다.
route[]

object (LatLng)

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

string

출력 전용입니다. 다음 웨이포인트의 인코딩된 경로입니다.

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

string (Timestamp format)

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

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

출력 전용입니다. currentRouteSegment의 교통상황을 나타냅니다(제공되는 경우).

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

string (Timestamp format)

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

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
currentRouteSegmentEndPoint

object (TripWaypoint)

출력 전용입니다. currentRouteSegment가 종료되는 웨이포인트입니다.
remainingDistanceMeters

integer

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

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
remainingTimeToFirstWaypoint

string (Duration format)

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

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

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
remainingWaypointsRouteVersion

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
stopTime
(deprecated)

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

TripView

trips.get 응답의 다양한 경로 필드 집합을 위한 선택기입니다. 컨텍스트는 AIP-157을 참고하세요. 추가 뷰가 추가될 가능성이 있습니다.

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

메서드

create

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

delete

 단일 이동을 삭제합니다.

get

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

update

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