리소스: 이동
이동 메타데이터입니다.
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에 이동을 만들고 새 이동을 반환합니다. |
|
단일 경로에 대한 정보를 확인합니다. |
|
특정 차량의 모든 경로를 가져옵니다. |
|
경로 데이터를 업데이트합니다. |