- 리소스: Trip
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- TripStatus
- StopLocation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- TripView
- 메서드
리소스: 경로
경로 메타데이터입니다.
JSON 표현 |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
필드 | |
---|---|
name |
출력 전용입니다. 'providers/{provider}/trips/{trip} 형식입니다. |
vehicleId |
이 이동을 수행하는 차량의 ID입니다. |
tripStatus |
이동의 현재 상태입니다. |
tripType |
여행 유형입니다. |
pickupPoint |
고객에게 픽업할 예정이라고 표시한 위치입니다. |
actualPickupPoint |
입력 전용입니다. 고객이 픽업한 시간과 장소 제공업체가 실제 수령 정보에 관한 의견을 제공하는 필드입니다. |
actualPickupArrivalPoint |
입력 전용입니다. 운전자가 승차 지점에 도착한 실제 시간 및 위치입니다. 이 필드는 제공업체가 승차 지점의 실제 도착 정보에 관한 피드백을 제공하기 위한 것입니다. |
pickupTime |
출력 전용입니다. 탑승자가 픽업할 것으로 예상되는 향후 시간 또는 실제 픽업 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
intermediateDestinations[] |
이동에서 요청한 중간 정류장입니다 (승차 및 하차 외에도). 처음에는 공유 여정에 이 기능이 지원되지 않습니다. |
intermediateDestinationsVersion |
RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
intermediateDestinationIndex |
|
actualIntermediateDestinationArrivalPoints[] |
입력 전용입니다. 운전자가 중간 목적지에 도착한 실제 시간 및 위치입니다. 이 필드는 제공업체가 중간 목적지의 실제 도착 정보에 관한 피드백을 제공하는 데 사용됩니다. |
actualIntermediateDestinations[] |
입력 전용입니다. 중간 목적지에서 고객이 승차한 실제 시간 및 위치입니다. 제공업체가 중간 목적지에서의 실제 승차 정보에 관한 의견을 제공하는 필드입니다. |
dropoffPoint |
고객이 하차한다고 표시한 위치입니다. |
actualDropoffPoint |
입력 전용입니다. 고객이 하차한 실제 시간 및 위치입니다. 이 필드는 제공업체가 실제 하차 정보에 관한 의견을 제공하는 데 사용됩니다. |
dropoffTime |
출력 전용입니다. 탑승자가 최종 목적지에 하차할 예상 시간 또는 하차한 실제 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
remainingWaypoints[] |
출력 전용입니다. 현재 위치에서 하차 지점까지의 전체 경로입니다(해당 위치 포함). 이 경로에는 다른 여정의 경유지가 포함될 수 있습니다. |
vehicleWaypoints[] |
이 필드는 이동에 대한 경유지의 수동 순서를 지원합니다. 이 경로에는 할당된 차량의 나머지 모든 경유지와 함께 이 이동의 승차 및 하차 경유지가 포함됩니다. 이동이 차량에 할당되지 않은 경우 Fleet Engine에서 이 필드를 무시합니다. 개인 정보 보호를 위해 이 필드는 |
route[] |
출력 전용입니다. 남은 Waypoint의 첫 번째 진입 지점으로 가는 이 이동의 예상 경로입니다. 첫 번째 경유지는 다른 이동에 속할 수 있습니다. |
currentRouteSegment |
출력 전용입니다. 다음 경유지에 대한 인코딩된 경로입니다. 참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다. |
currentRouteSegmentVersion |
출력 전용입니다. 경로가 마지막으로 수정된 시간을 나타냅니다. 참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
currentRouteSegmentTraffic |
출력 전용입니다. 참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다. |
currentRouteSegmentTrafficVersion |
출력 전용입니다. 참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
currentRouteSegmentEndPoint |
출력 전용입니다. |
remainingDistanceMeters |
출력 전용입니다. |
etaToFirstWaypoint |
출력 전용입니다. 다음 경유지까지의 도착예정시간 ( RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
remainingTimeToFirstWaypoint |
출력 전용입니다. 이동 데이터가 반환된 시점부터 소수점 아래가 최대 9자리까지이고 ' |
remainingWaypointsVersion |
출력 전용입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
remainingWaypointsRouteVersion |
출력 전용입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
numberOfPassengers |
변경할 수 없습니다. 이 이동의 승객 수를 나타내며 운전자는 포함하지 않습니다. 차량에 |
lastLocation |
출력 전용입니다. 경로를 따라 차량의 마지막으로 보고된 위치를 나타냅니다. |
lastLocationSnappable |
출력 전용입니다. 차량의 |
view |
채워지는 이동 필드의 하위 집합 및 해석 방법입니다. |
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 ( |
필드 | |
---|---|
point |
필수 항목입니다. 실제 위치를 나타냅니다. |
timestamp |
정류장이 발생한 시간을 나타냅니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
stopTime |
입력 전용입니다. 지원 중단되었습니다. 타임스탬프 필드를 사용합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
TripView
trips.get
응답에서 여러 이동 필드 집합의 선택기입니다. 관련 내용은 AIP-157을 참고하세요. 뷰가 추가될 가능성이 높습니다.
열거형 | |
---|---|
TRIP_VIEW_UNSPECIFIED |
기본값입니다. 이전 버전과의 호환성을 위해 API는 기본적으로 SDK 보기로 설정됩니다. 안정성 및 지원을 위해 고객은 SDK 가 아닌 TripView 을 선택하는 것이 좋습니다. |
SDK |
공개적으로 사용 가능한 라이브러리를 사용하여 해석하거나 지원할 수 없는 필드가 포함됩니다. |
JOURNEY_SHARING_V1S |
여행 필드는 여정 공유 사용 사례에 맞게 채워집니다. 이 보기는 서버 간 통신에 사용됩니다. |
메서드 |
|
---|---|
|
Fleet Engine에서 이동을 만들고 새 이동을 반환합니다. |
|
단일 경로에 대한 정보를 가져옵니다. |
|
특정 차량의 모든 여정 가져오기 |
|
경로 데이터를 업데이트합니다. |