Fleet Engine Entities

작업 인터페이스

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
작업 결과 위치의 설정자입니다 ('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
작업의 예상 완료 시간입니다.
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
제공업체가 작업의 결과를 설정한 시간입니다.

여행 인터페이스

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
이 배송 차량에 할당된 여정 세그먼트입니다. 차량의 가장 최근에 보고된 위치에서 시작됩니다. FleetEngineDeliveryVehicleLocationProvider을 통해 DeliveryVehicle 데이터 객체가 제공되는 경우에만 채워집니다.
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
속도(단위: km/h)입니다.
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 오토바이, 모페드 또는 기타 이륜차
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부터 시작하는 색인입니다.