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.get 호출이 아닌 trips.update 및 trips.create 호출에서만 서버에 채워집니다.
route[]

object (LatLng)

출력 전용. 나머지 Waypoint의 첫 번째 항목에 대한 이 경로의 예상 경로입니다. 첫 번째 경유지는 다른 이동에 속할 수 있습니다.
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가 없으면 거짓입니다. Fleet Engine에서 계산됩니다. 클라이언트의 모든 업데이트는 무시됩니다.
view

enum (TripView)

채워지는 이동 필드의 하위 집합 및 해석되는 방식입니다.

이동 상태

진행 상태를 나타내는 이동 상태입니다.

열거형
UNKNOWN_TRIP_STATUS 지정되지 않거나 알 수 없는 이동 상태에 사용되는 기본값입니다.
NEW 새로 만든 여행입니다.
ENROUTE_TO_PICKUP 운전자가 승차장으로 이동 중입니다.
ARRIVED_AT_PICKUP 운전자가 승차 지점에 도착했습니다.
ARRIVED_AT_INTERMEDIATE_DESTINATION 운전자가 중간 목적지에 도착하여 탑승자를 기다리고 있습니다.
ENROUTE_TO_INTERMEDIATE_DESTINATION 운전자가 하차 지점이 아닌 중간 목적지까지 이동 중입니다.
ENROUTE_TO_DROPOFF 운전자가 탑승자를 잡았으며 다음 목적지로 이동 중입니다.
COMPLETE 탑승자가 하차했으며 이동이 완료되었습니다.
CANCELED 운전자, 탑승자 또는 차량 공유 제공업체에서 수령 전에 이동을 취소했습니다.

정류장 위치

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

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)

입력 전용. 지원이 중단되었습니다. timestamp 필드를 사용합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z"

경로 보기

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

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

방법

create

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

get

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

update

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