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
이전 경유지 (또는 경유지 목록의 첫 번째 경유지인 경우 차량의 현재 위치)에서 이 경유지까지의 경로입니다.
speedReadingIntervals optional
유형:  Array<SpeedReadingInterval> optional
이전 경유지 (또는 차량 위치)에서 현재 경유지까지의 경로를 따라 이동하는 교통 속도의 목록입니다. 목록의 각 구간은 경로에 있는 인접한 구간의 트래픽을 설명하며, 구간은 색인을 통해 구간의 시작 지점과 종료 지점을 정의합니다. 자세한 내용은 SpeedReadingInterval의 정의를 참고하세요.

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
유형:  LatLng optional
경유지의 위치입니다.
path optional
유형:  Array<LatLng> optional
이전 정류장 (또는 정류장 목록의 첫 번째 정류장인 경우 차량의 현재 위치)에서 이 정류장까지의 경로입니다.
speedReadingIntervals optional
유형:  Array<SpeedReadingInterval> optional
이전 경유지 (또는 차량 위치)에서 현재 경유지까지의 경로를 따라 이동하는 교통 속도의 목록입니다. 목록의 각 구간은 경로에 있는 인접한 구간의 트래픽을 설명하며, 구간은 색인을 통해 구간의 시작 지점과 종료 지점을 정의합니다. 자세한 내용은 SpeedReadingInterval의 정의를 참고하세요.
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
기간의 시작 시간입니다 (해당 시간 포함).

속도 상수

google.maps.journeySharing.Speed 상수

교통정보 데이터를 기반으로 한 다중선 속도 분류입니다.

const {Speed} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
NORMAL 정상 속도, 감속이 감지되지 않습니다.
SLOW 감속이 감지되었지만 교통체증은 발생하지 않았습니다.
TRAFFIC_JAM 교통체증이 감지되었습니다.

SpeedReadingInterval 인터페이스

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

인접한 경로 세그먼트의 교통량 표시기입니다. 간격은 색인을 통해 세그먼트의 시작 지점과 종료 지점을 정의합니다.
endPolylinePointIndex
유형:  number
경로에 있는 간격 끝점의 0 기반 색인입니다.
speed
유형:  Speed
이 간격의 트래픽 속도입니다.
startPolylinePointIndex
유형:  number
경로에 있는 간격 시작점의 0 기반 색인입니다.