Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider 클래스

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider 클래스

배송 차량 위치 정보 제공자입니다.

이 클래스는 PollingLocationProvider를 확장합니다.

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

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
매개변수: 
Fleet Engine 배송 차량의 새 위치 제공자를 만듭니다.
deliveryVehicleId
유형:  string
이 위치 제공자가 관찰하는 차량의 ID입니다. 차량을 추적하려면 이 필드를 설정합니다.
shouldShowOutcomeLocations
유형:  boolean optional
선택적으로 사용자가 작업의 결과 위치를 표시하도록 허용합니다.
shouldShowTasks
유형:  boolean optional
선택적으로 사용자가 가져온 작업을 표시하도록 허용합니다.
staleLocationThresholdMillis
유형:  number
이 필드는 읽기 전용입니다. 오래된 차량 위치의 기준입니다. 차량의 마지막 업데이트 위치가 이 기준보다 오래된 경우 차량이 표시되지 않습니다.
taskFilterOptions
작업을 가져올 때 적용할 필터 옵션을 반환합니다.
상속됨: isPolling, pollingIntervalMillis
상속됨: addListener
error
function(event)
인수: 
위치 제공자가 오류를 발견할 때 트리거되는 이벤트입니다.
update
function(event)
Fleet Engine 데이터 업데이트 요청이 완료될 때 트리거되는 이벤트입니다.
상속됨: ispollingchange

FleetEngineDeliveryVehicleLocationProviderOptions 인터페이스

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

배송 차량 위치 제공업체 옵션입니다.

authTokenFetcher
클라이언트를 Fleet Engine에 인증하기 위한 JSON 웹 토큰을 제공합니다.
projectId
유형:  string
Google Cloud Console의 소비자 프로젝트 ID입니다.
activePolylineCustomization optional
활성 다중선에 적용된 맞춤설정입니다. 활성 다중선은 차량이 현재 통과하는 경로의 일부에 해당합니다.

이 필드를 사용하여 맞춤 스타일 (예: 폴리라인 색상)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • PolylineOptions 객체가 지정되면 폴리라인이 생성된 후 객체에 지정된 변경사항이 폴리라인에 적용되어 기본 옵션이 있는 경우 덮어씁니다.
  • 함수가 지정된 경우 폴리라인이 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 폴리라인의 좌표가 변경되거나 위치 제공자가 이 폴리라인에 해당하는 데이터가 변경되었는지 여부와 관계없이 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 DeliveryVehiclePolylineCustomizationFunctionParams를 참고하세요.
deliveryVehicleId optional
유형:  string optional
위치 제공자가 인스턴스화된 후 즉시 추적할 배송 차량 ID입니다. 지정하지 않으면 위치 제공자가 차량을 추적하지 않습니다. FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId를 사용하여 ID를 설정하고 추적을 시작하세요.
deliveryVehicleMarkerCustomization optional
배송 차량 마커에 적용된 맞춤설정입니다.

이 필드를 사용하여 맞춤 스타일 (예: 마커 아이콘)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • MarkerOptions 객체가 지정되면 마커가 생성된 후 객체에 지정된 변경사항이 마커에 적용되어 기본 옵션이 있는 경우 이를 덮어씁니다.
  • 함수가 지정된 경우 마커가 지도 뷰에 추가되기 전에 마커가 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 이 마커에 해당하는 데이터가 변경되었는지 여부와 관계없이 위치 제공자가 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 DeliveryVehicleMarkerCustomizationFunctionParams를 참고하세요.
plannedStopMarkerCustomization optional
유형:  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
계획된 정차 지점 마커에 적용된 맞춤설정입니다.

이 필드를 사용하여 맞춤 스타일 (예: 마커 아이콘)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • MarkerOptions 객체가 지정되면 마커가 생성된 후 객체에 지정된 변경사항이 마커에 적용되어 기본 옵션이 있는 경우 이를 덮어씁니다.
  • 함수가 지정된 경우 마커가 지도 뷰에 추가되기 전에 마커가 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 이 마커에 해당하는 데이터가 변경되었는지 여부와 관계없이 위치 제공자가 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 PlannedStopMarkerCustomizationFunctionParams를 참고하세요.
pollingIntervalMillis optional
유형:  number optional
위치 업데이트를 가져오는 사이의 최소 시간(밀리초)입니다. 위치 업데이트를 가져오는 데 pollingIntervalMillis보다 오래 걸리면 현재 업데이트가 완료될 때까지 다음 위치 업데이트가 시작되지 않습니다.

이 값을 0으로 설정하면 반복적인 위치 업데이트가 사용 중지됩니다. 위치 제공자가 관찰하는 매개변수가 변경되면 새로운 위치 업데이트가 가져와집니다.

기본 폴링 간격은 최소 간격인 5, 000밀리초입니다. 폴링 간격을 0이 아닌 더 낮은 값으로 설정하면 5000이 사용됩니다.
remainingPolylineCustomization optional
나머지 다중선에 적용된 맞춤설정입니다. 나머지 폴리라인은 차량이 아직 통과하지 않은 경로의 일부에 해당합니다.

이 필드를 사용하여 맞춤 스타일 (예: 폴리라인 색상)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • PolylineOptions 객체가 지정되면 폴리라인이 생성된 후 객체에 지정된 변경사항이 폴리라인에 적용되어 기본 옵션이 있는 경우 덮어씁니다.
  • 함수가 지정된 경우 폴리라인이 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 폴리라인의 좌표가 변경되거나 위치 제공자가 이 폴리라인에 해당하는 데이터가 변경되었는지 여부와 관계없이 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 DeliveryVehiclePolylineCustomizationFunctionParams를 참고하세요.
shouldShowOutcomeLocations optional
유형:  boolean optional
가져온 작업의 결과 위치를 표시하거나 숨기는 불리언입니다.
shouldShowTasks optional
유형:  boolean optional
할 일을 표시하거나 숨기는 불리언입니다. false로 설정하면 ListTasks 엔드포인트가 호출되어 작업을 가져오지 않습니다. 예정된 차량 정류장만 표시됩니다.
staleLocationThresholdMillis optional
유형:  number optional
오래된 차량 위치의 기준입니다. 차량의 마지막 업데이트 위치가 이 기준보다 오래된 경우 차량이 표시되지 않습니다. 기본값은 24시간(밀리초)입니다. 임계값이 0보다 작거나 무한대인 경우 임계값이 무시되고 차량 위치가 오래된 것으로 간주되지 않습니다.
takenPolylineCustomization optional
촬영된 다중선에 적용된 맞춤설정입니다. 이동한 다중선은 차량이 이미 통과한 경로의 일부에 해당합니다.

이 필드를 사용하여 맞춤 스타일 (예: 폴리라인 색상)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • PolylineOptions 객체가 지정되면 폴리라인이 생성된 후 객체에 지정된 변경사항이 폴리라인에 적용되어 기본 옵션이 있는 경우 덮어씁니다.
  • 함수가 지정된 경우 폴리라인이 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 폴리라인의 좌표가 변경되거나 위치 제공자가 이 폴리라인에 해당하는 데이터가 변경되었는지 여부와 관계없이 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 DeliveryVehiclePolylineCustomizationFunctionParams를 참고하세요.
taskFilterOptions optional
유형:  FleetEngineTaskFilterOptions optional
작업을 가져올 때 적용할 필터 옵션입니다. 옵션에는 특정 차량, 시간, 작업 상태가 포함될 수 있습니다.
taskMarkerCustomization optional
유형:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
작업 마커에 적용된 맞춤설정입니다. 작업 마커는 배송 차량에 할당된 각 작업의 계획된 위치에 렌더링됩니다.

이 필드를 사용하여 맞춤 스타일 (예: 마커 아이콘)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • MarkerOptions 객체가 지정되면 마커가 생성된 후 객체에 지정된 변경사항이 마커에 적용되어 기본 옵션이 있는 경우 이를 덮어씁니다.
  • 함수가 지정된 경우 마커가 지도 뷰에 추가되기 전에 마커가 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 이 마커에 해당하는 데이터가 변경되었는지 여부와 관계없이 위치 제공자가 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 TaskMarkerCustomizationFunctionParams를 참고하세요.
taskOutcomeMarkerCustomization optional
유형:  function(TaskMarkerCustomizationFunctionParams): void optional
작업 결과 마커에 적용된 맞춤설정입니다. 작업 결과 마커는 배송 차량에 할당된 각 작업의 실제 결과 위치에 렌더링됩니다.

이 필드를 사용하여 맞춤 스타일 (예: 마커 아이콘)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • MarkerOptions 객체가 지정되면 마커가 생성된 후 객체에 지정된 변경사항이 마커에 적용되어 기본 옵션이 있는 경우 이를 덮어씁니다.
  • 함수가 지정된 경우 마커가 지도 뷰에 추가되기 전에 마커가 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 이 마커에 해당하는 데이터가 변경되었는지 여부와 관계없이 위치 제공자가 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 TaskMarkerCustomizationFunctionParams를 참고하세요.

FleetEngineTaskFilterOptions 인터페이스

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

배송 차량 위치 제공자의 작업 필터링 옵션입니다.

completionTimeFrom optional
유형:  Date optional
작업 완료 시간의 하한값(제외)입니다. 지정된 시간 이후에 완료된 작업을 필터링하는 데 사용됩니다.
completionTimeTo optional
유형:  Date optional
작업 완료 시간의 상한값(제외)입니다. 지정된 시간 전에 완료된 작업을 필터링하는 데 사용됩니다.
state optional
유형:  string optional
작업의 상태입니다. 유효한 값은 OPEN 또는 CLOSED입니다.

FleetEngineDeliveryVehicleLocationProviderUpdateEvent 인터페이스

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

FleetEngineDeliveryVehicleLocationProvider.update 이벤트가 트리거될 때 이벤트 핸들러에 전달되는 이벤트 객체입니다.

completedVehicleJourneySegments optional
유형:  Array<VehicleJourneySegment> optional
이 차량이 완료한 여정 세그먼트입니다. 수정할 수 없습니다.
deliveryVehicle optional
유형:  DeliveryVehicle optional
업데이트에 의해 반환된 배송 차량 데이터 구조입니다. 수정할 수 없습니다.
tasks optional
유형:  Array<Task> optional
이 배송 차량에서 처리하는 작업 목록입니다. 수정할 수 없습니다.

FleetEngineDeliveryFleetLocationProvider 클래스

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider 클래스

배송 차량 위치 정보 제공자입니다.

이 클래스는 PollingLocationProvider를 확장합니다.

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

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
매개변수: 
Fleet Engine에서 추적하는 차량의 새 위치 제공자를 만듭니다.
deliveryVehicleFilter
유형:  string optional
배송 차량을 가져올 때 적용된 필터입니다.
locationRestriction
배송 차량을 추적할 범위입니다. 경계가 설정되지 않으면 배송 차량이 추적되지 않습니다. 위치에 관계없이 모든 배송 차량을 추적하려면 지구 전체에 해당하는 경계를 설정하세요.
staleLocationThresholdMillis
유형:  number
이 필드는 읽기 전용입니다. 오래된 차량 위치의 기준입니다. 차량의 마지막 업데이트 위치가 이 기준보다 오래된 경우 차량이 표시되지 않습니다.
상속됨: isPolling, pollingIntervalMillis
상속됨: addListener
update
function(event)
Fleet Engine 데이터 업데이트 요청이 완료될 때 트리거되는 이벤트입니다.
상속됨: ispollingchange

FleetEngineDeliveryFleetLocationProviderOptions 인터페이스

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

배송 차량 위치 제공업체의 옵션입니다.

authTokenFetcher
클라이언트를 Fleet Engine에 인증하기 위한 JSON 웹 토큰을 제공합니다.
projectId
유형:  string
Google Cloud Console의 소비자 프로젝트 ID입니다.
deliveryVehicleFilter optional
유형:  string optional
배송 차량을 가져올 때 적용할 필터 쿼리입니다. 이 필터는 Fleet Engine에 직접 전달됩니다.

지원되는 형식은 ListDeliveryVehiclesRequest.filter를 참고하세요.

속성의 유효한 필터에는 'attributes' 접두사가 있어야 합니다. 예를 들면 attributes.x = "y" 또는 attributes."x y" = "z"입니다.
deliveryVehicleMarkerCustomization optional
유형:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
배송 차량 마커에 적용된 맞춤설정입니다.

이 필드를 사용하여 맞춤 스타일 (예: 마커 아이콘)과 상호작용 (예: 클릭 처리)을 지정합니다.
  • MarkerOptions 객체가 지정되면 마커가 생성된 후 객체에 지정된 변경사항이 마커에 적용되어 기본 옵션이 있는 경우 이를 덮어씁니다.
  • 함수가 지정된 경우 마커가 지도 뷰에 추가되기 전에 마커가 생성될 때 한 번 호출됩니다. (이 호출에서 함수 매개변수 객체의 isNew 매개변수는 true로 설정됩니다.) 또한 이 함수는 이 마커에 해당하는 데이터가 변경되었는지 여부와 관계없이 위치 제공자가 Fleet Engine에서 데이터를 수신할 때 호출됩니다.

    제공된 매개변수와 그 사용 목록은 DeliveryVehicleMarkerCustomizationFunctionParams를 참고하세요.
locationRestriction optional
위치 제공자가 인스턴스화된 직후에 차량을 추적할 위도/경도 경계입니다. 설정하지 않으면 위치 제공자가 차량 추적을 시작하지 않습니다. FleetEngineDeliveryFleetLocationProvider.locationRestriction를 사용하여 경계를 설정하고 추적을 시작하세요. 위치에 관계없이 모든 배송 차량을 추적하려면 지구 전체에 해당하는 경계를 설정하세요.
staleLocationThresholdMillis optional
유형:  number optional
오래된 차량 위치의 기준입니다. 차량의 마지막 업데이트 위치가 이 기준보다 오래된 경우 차량이 표시되지 않습니다. 기본값은 24시간(밀리초)입니다. 임계값이 0 미만이거나 무한대인 경우 임계값이 무시되고 차량 위치가 오래된 것으로 간주되지 않습니다.

FleetEngineDeliveryFleetLocationProviderUpdateEvent 인터페이스

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

FleetEngineDeliveryFleetLocationProvider.update 이벤트가 트리거될 때 이벤트 핸들러에 전달되는 이벤트 객체입니다.

deliveryVehicles optional
유형:  Array<DeliveryVehicle> optional
쿼리로 반환된 배송 차량 목록입니다. 수정할 수 없습니다.