Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider 클래스

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class
extends PollingLocationProvider
library "journeySharing"

배송 차량 위치 정보 제공업체

const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
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 콘솔의 소비자 프로젝트 ID입니다.
activePolylineCustomization
선택사항
활성 다중선에 적용된 맞춤설정입니다. 활성 다중선은 차량이 현재 이동 중인 경로의 일부에 해당합니다.

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

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

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

    제공된 매개변수 및 용도 목록은 DeliveryVehicleMarkerCustomizationFunctionParams를 참고하세요.
plannedStopMarkerCustomization
선택사항
계획된 경유지 마커에 적용된 맞춤설정입니다.

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

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

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

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

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

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

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

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

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

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

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

    제공된 매개변수 및 용도 목록은 TaskMarkerCustomizationFunctionParams를 참고하세요.

FleetEngineTaskFilterOptions 인터페이스

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

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

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

FleetEngineDeliveryVehicleLocationProviderUpdateEvent 인터페이스

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

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

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

FleetEngineDeliveryFleetLocationProvider 클래스

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class
extends PollingLocationProvider
library "journeySharing"

배송 차량 위치 정보 제공자

const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
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 콘솔의 소비자 프로젝트 ID입니다.
deliveryVehicleFilter
선택사항
유형: string optional
배송 차량을 가져올 때 적용할 필터 쿼리입니다. 이 필터는 Fleet Engine에 직접 전달됩니다.

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

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

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

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

FleetEngineDeliveryFleetLocationProviderUpdateEvent 인터페이스

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

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

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