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 콘솔의 소비자의 프로젝트 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, 무한대 또는 음수 값으로 설정하면 자동 위치 업데이트가 사용 중지됩니다. 추적 ID 매개변수 (예: 배송 위치 제공업체의 배송 추적 ID) 또는 필터링 옵션 (예: 표시 영역 경계 또는 차량 위치 제공업체의 속성 필터)이 변경되면 새 위치 업데이트를 한 번 가져옵니다.

기본값이자 최소 폴링 간격은 5,000밀리초입니다. 폴링 간격을 더 낮은 양수 값으로 설정하면 5, 000이 저장되고 사용됩니다.
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
업데이트에서 반환된 작업 추적 정보 구조입니다. 수정할 수 없습니다.