Fleet Engine Entities

Task 인터페이스

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

Fleet 엔진에서 반환한 태스크의 세부정보입니다.
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
태스크 결과 위치 ('PROVIDER' 또는 'LAST_VEHICLE_LOCATION')의 setter입니다.
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
태스크의 예상 완료 시간입니다.
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의 정의를 참고하세요.

차량 인터페이스

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

Fleet Engine에서 반환한 차량의 세부정보입니다.
attributes
유형:  Object<string, *>
맞춤 차량 속성
name
유형:  string
'providers/{provider_id}/vehicles/{vehicle_id}' 형식입니다. vehicle_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
이 차량에 할당된 나머지 웨이포인트입니다.
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 오토바이, 모페드 또는 기타 2륜 차량
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부터 시작하는 색인입니다.