Shipment Tracking

FleetEngineShipmentLocationProvider 클래스

google.maps.journeySharing.FleetEngineShipmentLocationProvider 클래스

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

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

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
매개변수: 
Fleet Engine 배송 추적을 위한 새 위치 제공자를 만듭니다.
trackingId
유형:  string
이 위치 제공자가 관찰하는 작업의 추적 ID입니다. 추적을 시작하려면 이 필드를 설정하세요.
상속됨: isPolling, pollingIntervalMillis
refresh
refresh()
매개변수:  없음
반환 값:  void
추적된 위치를 명시적으로 새로고침합니다.
상속됨: addListener
error
function(event)
인수: 
위치 제공자가 오류를 발견할 때 트리거되는 이벤트입니다.
update
function(event)
인수: 
Fleet Engine 데이터 업데이트 요청이 완료될 때 트리거되는 이벤트입니다.
상속됨: ispollingchange

FleetEngineShipmentLocationProviderOptions 인터페이스

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

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

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

    제공된 매개변수와 그 사용 목록은 ShipmentPolylineCustomizationFunctionParams를 참고하세요.
deliveryVehicleMarkerCustomization optional
유형:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
배송 차량 마커에 적용된 맞춤설정입니다.

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

    제공된 매개변수와 그 사용 목록은 ShipmentMarkerCustomizationFunctionParams를 참고하세요.
destinationMarkerCustomization optional
유형:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
대상 마커에 적용된 맞춤설정입니다.

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

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

이 값을 0, Infinity 또는 음수 값으로 설정하면 자동 위치 업데이트가 사용 중지됩니다. 추적 ID 매개변수 (예: 배송 위치 제공업체의 배송 추적 ID) 또는 필터링 옵션 (예: 차량 위치 제공업체의 뷰포트 경계 또는 속성 필터)이 변경되면 새 위치 업데이트가 한 번 가져옵니다.

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

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

    제공된 매개변수와 그 사용 목록은 ShipmentPolylineCustomizationFunctionParams를 참고하세요.
takenPolylineCustomization optional
촬영된 다중선에 적용된 맞춤설정입니다. 이동한 다중선은 차량이 이미 통과한 경로의 일부에 해당합니다.

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

    제공된 매개변수와 그 사용 목록은 ShipmentPolylineCustomizationFunctionParams를 참고하세요.
trackingId optional
유형:  string optional
위치 제공자가 인스턴스화된 후 즉시 추적할 작업의 추적 ID입니다. 지정하지 않으면 위치 제공자가 작업을 추적하지 않습니다. FleetEngineShipmentLocationProvider.trackingId를 사용하여 추적 ID를 설정하고 추적을 시작하세요.

FleetEngineShipmentLocationProviderUpdateEvent 인터페이스

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

FleetEngineShipmentLocationProvider.update 이벤트가 트리거될 때 이벤트 핸들러에 전달되는 이벤트 객체입니다.
taskTrackingInfo optional
유형:  TaskTrackingInfo optional
업데이트에 의해 반환된 작업 추적 정보 구조입니다. 수정할 수 없습니다.