Shipment Tracking

FleetEngineShipmentLocationProvider 클래스

class google.maps.journeySharing.FleetEngineShipmentLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FleetEngineShipmentLocationProviderUpdateEvent 인터페이스

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

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

taskTrackingInfo
선택사항
유형: TaskTrackingInfo optional
업데이트에서 반환된 작업 추적 정보 구조입니다. 수정할 수 없습니다.