Fleet Engine Entities

Task 인터페이스

google.maps.journeySharing.Task 인터페이스

Fleet Engine에서 반환한 태스크의 세부정보입니다.

attributes
유형:  Object<string, *>
작업에 할당된 속성입니다.
name
유형:  string
'providers/{provider_id}/tasks/{task_id}' 형식의 태스크 이름입니다. task_id는 추적 ID가 아닌 고유 식별자여야 합니다. 배송의 추적 ID를 저장하려면 tracking_id 필드를 사용하세요. 여러 태스크에서 동일한 tracking_id를 가질 수 있습니다.
remainingVehicleJourneySegments
이 작업을 위해 완료해야 하는 세그먼트에 관한 정보입니다.
status
유형:  string
태스크의 현재 실행 상태입니다.
type
유형:  string
작업 유형입니다(예: 중단 또는 배송).
estimatedCompletionTime optional
유형:  Date optional
태스크의 예상 완료 시간 타임스탬프입니다.
latestVehicleLocationUpdate optional
유형:  VehicleLocationUpdate optional
마지막 위치 업데이트 관련 정보입니다.
outcome optional
유형:  string optional
작업의 결과입니다.
outcomeLocation optional
유형:  LatLngLiteral optional
(제공업체에서) 작업이 완료된 위치입니다.
outcomeLocationSource optional
유형:  string optional
할 일 결과 위치의 setter입니다 ('PROVIDER' 또는 'LAST_VEHICLE_LOCATION').
outcomeTime optional
유형:  Date optional
제공업체로부터 작업 결과가 설정된 시점의 타임스탬프입니다.
plannedLocation optional
유형:  LatLngLiteral optional
작업을 완료할 위치입니다.
targetTimeWindow optional
유형:  TimeWindow optional
작업이 완료되어야 하는 기간입니다.
trackingId optional
유형:  string optional
배송의 추적 ID입니다.
vehicleId optional
유형:  string optional
이 작업을 실행하는 차량의 ID입니다.

TaskInfo 인터페이스

google.maps.journeySharing.TaskInfo 인터페이스

DeliveryVehicleStop에서 사용하는 TaskInfo 유형입니다.

extraDurationMillis optional
유형:  number optional
작업을 수행하는 데 걸리는 추가 시간(밀리초)입니다.
id optional
유형:  string optional
작업의 ID입니다.
targetTimeWindow optional
유형:  TimeWindow optional
작업이 완료되어야 하는 기간입니다.

TaskTrackingInfo 인터페이스

google.maps.journeySharing.TaskTrackingInfo 인터페이스

Fleet Engine에서 반환된 태스크 추적 정보 객체의 세부정보입니다.

attributes
유형:  Object<string, *>
작업에 할당된 속성입니다.
name
유형:  string
'providers/{provider_id}/taskTrackingInfo/{tracking_id}' 형식의 이름입니다. 여기서 tracking_id는 추적 ID를 나타냅니다.
trackingId
유형:  string
작업의 추적 ID입니다.
  • 유효한 유니코드 문자열이어야 합니다.
  • 최대 길이는 64자(영문 기준)로 제한됩니다.
  • 유니코드 정규화 형식 C에 따라 정규화됩니다.
  • ASCII 문자 '/', ':', '?', ',' 또는 '#'은 사용할 수 없습니다.
estimatedArrivalTime optional
유형:  Date optional
정류장 위치까지의 예상 도착 시간입니다.
estimatedTaskCompletionTime optional
유형:  Date optional
Task의 예상 완료 시간입니다.
latestVehicleLocationUpdate optional
유형:  VehicleLocationUpdate optional
마지막 위치 업데이트 관련 정보입니다.
plannedLocation optional
유형:  LatLng optional
작업이 완료될 위치입니다.
remainingDrivingDistanceMeters optional
유형:  number optional
관심 있는 VehicleStop까지의 총 남은 거리(미터)입니다.
remainingStopCount optional
유형:  number optional
작업 정류장을 포함하여 작업 정류장에 도달할 때까지 남아 있는 차량의 정차 횟수를 나타냅니다. 예를 들어 차량의 다음 정류장이 작업 정류장인 경우 값은 1이 됩니다.
routePolylinePoints optional
유형:  Array<LatLng> optional
연결되었을 때 이 작업의 위치로 가는 차량 예상 경로의 다중선을 형성하는 점의 목록입니다.
state optional
유형:  string optional
작업의 현재 실행 상태입니다.
targetTimeWindow optional
유형:  TimeWindow optional
작업이 완료되어야 하는 기간입니다.
taskOutcome optional
유형:  string optional
작업 실행을 시도한 결과
taskOutcomeTime optional
유형:  Date optional
제공업체가 작업의 결과를 설정한 시간입니다.

Trip 인터페이스

google.maps.journeySharing.Trip 인터페이스

Fleet Engine에서 반환한 이동의 세부정보입니다.

name
유형:  string
'providers/{provider_id}/trips/{trip_id}' 형식입니다. trip_id는 고유 식별자여야 합니다.
passengerCount
유형:  number
이 이동의 승객 수로, 운전자는 포함되지 않습니다.
remainingWaypoints
현재 위치에서 하차 지점까지의 경로를 나타내는 경유지의 배열입니다.
status
유형:  string
이동의 현재 상태입니다. 가능한 값은 UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE 또는 CANCELED입니다.
type
유형:  string
이동 유형입니다. 가능한 값은 UNKNOWN_TRIP_TYPE, SHARED 또는 EXCLUSIVE입니다.
vehicleId
유형:  string
이 이동을 진행하는 차량의 ID입니다.
actualDropOffLocation optional
유형:  LatLngLiteral optional
고객을 전달한 위치입니다.
actualPickupLocation optional
유형:  LatLngLiteral optional
고객을 픽업한 위치입니다.
dropOffTime optional
유형:  Date optional
승객이 하차할 것으로 예상되는 향후 시간 또는 실제 하차 시간입니다.
latestVehicleLocationUpdate optional
유형:  VehicleLocationUpdate optional
마지막 위치 업데이트 관련 정보입니다.
pickupTime optional
유형:  Date optional
향후 예상 승객 승차 시간 또는 실제 탑승 시간입니다.
plannedDropOffLocation optional
유형:  LatLngLiteral optional
고객이 하차한다고 명시한 위치입니다.
plannedPickupLocation optional
유형:  LatLngLiteral optional
고객이 픽업한다고 표시한 위치입니다.

DeliveryVehicle 인터페이스

google.maps.journeySharing.DeliveryVehicle 인터페이스

Fleet Engine에서 반환한 배송 차량의 세부정보입니다.

attributes
유형:  Object<string, string optional>
맞춤 배송 차량 속성입니다.
name
유형:  string
'providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}' 형식입니다. Delivery_vehicle_id는 고유 식별자여야 합니다.
navigationStatus
유형:  string
차량의 현재 내비게이션 상태입니다.
remainingDistanceMeters
유형:  number
현재 경로 구간의 남은 운전 거리(미터)입니다.
remainingVehicleJourneySegments
이 배송 차량에 할당된 여정 세그먼트로, 차량의 가장 최근에 보고된 위치부터 시작합니다. DeliveryVehicle 데이터 객체가 FleetEngineDeliveryVehicleLocationProvider를 통해 제공되는 경우에만 채워집니다.
currentRouteSegmentEndPoint optional
유형:  LatLngLiteral optional
현재 경로 구간이 끝나는 위치입니다.
latestVehicleLocationUpdate optional
유형:  VehicleLocationUpdate optional
배송 차량의 마지막으로 보고된 위치입니다.
remainingDurationMillis optional
유형:  number optional
현재 경로 구간의 남은 운전 시간(밀리초)입니다.

DeliveryVehicleStop 인터페이스

google.maps.journeySharing.DeliveryVehicleStop 인터페이스

DeliveryVehicleStop 유형

tasks
유형:  Array<TaskInfo>
이 정류장에서 수행할 태스크 목록입니다.
  • id: 작업의 ID입니다.
  • extraDurationMillis: 작업을 실행하는 데 걸리는 추가 시간(밀리초)입니다.
plannedLocation optional
유형:  LatLngLiteral optional
정류장의 위치입니다.
state optional
유형:  DeliveryVehicleStopState optional
정류장의 상태입니다.

DeliveryVehicleStopState 상수

google.maps.journeySharing.DeliveryVehicleStopState 상수

DeliveryVehicleStop의 현재 상태입니다.

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

ARRIVED 정류장에 도착했습니다. 차량이 다음 정류장으로 이동할 때 이전 정류장이 모두 완료되었다고 가정합니다.
ENROUTE 할당되었으며 능동적으로 라우팅합니다.
NEW 생성되었지만 활발하게 라우팅되지는 않습니다.
UNSPECIFIED 알 수 없는 작업입니다.

VehicleJourneySegment 인터페이스

google.maps.journeySharing.VehicleJourneySegment 인터페이스

VehicleJourneySegment 유형

drivingDistanceMeters optional
유형:  number optional
이전 정류장에서 이 정류장까지의 이동 거리(미터)입니다.
drivingDurationMillis optional
유형:  number optional
이 정류장의 이전 정류장으로부터의 이동 시간(밀리초)입니다.
path optional
유형:  Array<LatLngLiteral> optional
이전 정류장 (또는 정류장 목록의 첫 번째 정류장인 경우 차량의 현재 위치)에서 이 정류장까지의 경로입니다.
stop optional
유형:  DeliveryVehicleStop optional
정류장에 관한 정보입니다.

VehicleLocationUpdate 인터페이스

google.maps.journeySharing.VehicleLocationUpdate 인터페이스

VehicleLocationUpdate 유형

heading optional
유형:  number optional
업데이트의 제목입니다. 0은 북쪽, 180은 남쪽에 해당합니다.
location optional
유형:  LatLngLiteral|LatLng optional
업데이트 위치입니다.
speedKilometersPerHour optional
유형:  number optional
속도(시간당 킬로미터)입니다.
time optional
유형:  Date optional
이 업데이트가 차량에서 수신된 시간입니다.

VehicleWaypoint 인터페이스

google.maps.journeySharing.VehicleWaypoint 인터페이스

VehicleWaypoint 유형입니다.

distanceMeters optional
유형:  number optional
이전 경유지(또는 경유지 목록의 첫 번째 경유지인 경우 차량의 현재 위치)에서 이 경유지까지의 경로 거리(미터 단위).
durationMillis optional
유형:  number optional
이전 경유지(또는 경유지 목록의 첫 번째 경유지인 경우 차량의 현재 위치)에서 이 경유지까지의 이동 시간(밀리초)입니다.
location optional
유형:  LatLngLiteral optional
경유지의 위치입니다.
path optional
유형:  Array<LatLngLiteral> optional
이전 경유지 (또는 경유지 목록의 첫 번째 경유지인 경우 차량의 현재 위치)에서 이 경유지까지의 경로입니다.

Vehicle 인터페이스

google.maps.journeySharing.Vehicle 인터페이스

Fleet Engine에서 반환한 차량의 세부정보입니다.

attributes
유형:  Object<string, *>
맞춤 차량 속성입니다.
name
유형:  string
'providers/{provider_id}/vehicles/{vehicle_id}' 형식입니다. 차량_ID는 고유 식별자여야 합니다.
navigationStatus
차량의 현재 내비게이션 상태입니다.
remainingDistanceMeters
유형:  number
현재 경로 구간의 남은 운전 거리(미터)입니다.
vehicleState
유형:  VehicleState
차량 상태입니다.
vehicleType
유형:  VehicleType
차량의 유형입니다.
currentRouteSegmentEndPoint optional
유형:  TripWaypoint optional
현재 경로 세그먼트가 끝나는 경유지입니다.
currentRouteSegmentVersion optional
유형:  Date optional
현재 경로 구간이 설정된 시간입니다.
currentTrips optional
유형:  Array<string> optional
현재 이 차량에 할당된 이동의 이동 ID 목록입니다.
etaToFirstWaypoint optional
유형:  Date optional
경유지 필드의 첫 번째 항목에 대한 도착예정시간.
latestLocation optional
유형:  VehicleLocationUpdate optional
차량의 마지막으로 보고된 위치입니다.
maximumCapacity optional
유형:  number optional
이 차량에 탑승할 수 있는 총 탑승자 수입니다. 드라이버는 이 값에서 고려되지 않습니다.
supportedTripTypes optional
유형:  Array<TripType> optional
이 차량에서 지원하는 이동 유형입니다.
waypoints optional
유형:  Array<TripWaypoint> optional
이 Vehicle에 할당된 나머지 경유지입니다.
waypointsVersion optional
유형:  Date optional
경유지 필드가 마지막으로 업데이트된 시간입니다.

VehicleNavigationStatus 상수

google.maps.journeySharing.VehicleNavigationStatus 상수

Vehicle의 현재 탐색 상태입니다.

const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

ARRIVED_AT_DESTINATION 차량이 목적지에서 약 50m 이내에 있습니다.
ENROUTE_TO_DESTINATION 세부 경로 안내 탐색을 사용할 수 있으며 드라이버 앱 탐색이 GUIDED_NAV 모드로 전환되었습니다.
NO_GUIDANCE 드라이버 앱의 탐색이 FREE_NAV 모드입니다.
OFF_ROUTE 차량이 추천 경로를 벗어났습니다.
UNKNOWN_NAVIGATION_STATUS 탐색 상태가 지정되지 않았습니다.

VehicleState 상수

google.maps.journeySharing.VehicleState 상수

Vehicle의 현재 상태입니다.

const {VehicleState} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

OFFLINE 차량에서 새 경로를 수락하지 않습니다.
ONLINE 차량에서 새 경로를 수락합니다.
UNKNOWN_VEHICLE_STATE 알 수 없는 차량 상태입니다.

VehicleType 상수

google.maps.journeySharing.VehicleType 상수

Vehicle의 유형입니다.

const {VehicleType} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

AUTO 자동차
TAXI 택시 역할을 하는 모든 차량 (일반적으로 면허가 있거나 규제 대상임)
TRUCK 적재 공간이 큰 차량입니다.
TWO_WHEELER 오토바이, 모페드 또는 기타 이륜 차량.
UNKNOWN 알 수 없는 차량 유형입니다.

TripType 상수

google.maps.journeySharing.TripType 상수

Vehicle에서 지원하는 여행 유형입니다.

const {TripType} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

EXCLUSIVE 차량 전용 이동인 경우
SHARED 다른 이동과 차량을 공유할 수 있습니다.
UNKNOWN_TRIP_TYPE 알 수 없는 여행 유형입니다.

TripWaypoint 인터페이스

google.maps.journeySharing.TripWaypoint 인터페이스

TripWaypoint 유형입니다.

distanceMeters optional
유형:  number optional
이전 경유지(또는 경유지 목록의 첫 번째 경유지인 경우 차량의 현재 위치)에서 이 경유지까지의 경로 거리(미터 단위).
durationMillis optional
유형:  number optional
이전 경유지(또는 경유지 목록의 첫 번째 경유지인 경우 차량의 현재 위치)에서 이 경유지까지의 이동 시간(밀리초)입니다.
location optional
유형:  LatLngLiteral optional
경유지의 위치입니다.
tripId optional
유형:  string optional
이 경유지와 연관된 이동입니다.
waypointType optional
유형:  WaypointType optional
승차 또는 하차와 같이 이번 이동에서 이 경유지의 역할입니다.

WaypointType 상수

google.maps.journeySharing.WaypointType 상수

Vehicle에서 지원하는 경유지 유형입니다.

const {WaypointType} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

DROP_OFF_WAYPOINT_TYPE 탑승자의 하차 지점입니다.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE 다중 목적지 이동에서 중간 목적지의 경유지입니다.
PICKUP_WAYPOINT_TYPE 탑승자를 태우는 경유지입니다.
UNKNOWN_WAYPOINT_TYPE 알 수 없는 경유지 유형입니다.

TimeWindow 인터페이스

google.maps.journeySharing.TimeWindow 인터페이스

시간 범위.

endTime
유형:  Date
기간의 종료 시간입니다 (해당 시간 포함).
startTime
유형:  Date
기간의 시작 시간입니다 (해당 시간 포함).