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가 마지막으로 수정된 시간을 나타냅니다. 서버는 이 값을 캐시하고 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)

출력 전용. 남은 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가 없으면 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

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