Trip and Order Progress

FleetEngineTripLocationProvider 클래스

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

이동 위치 정보 제공자입니다.

const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
매개변수:
Fleet Engine 여정의 새 위치 제공자를 만듭니다.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
매개변수:
반환 값: 없음
속도 판독값에 따라 활성 다중선에 색상을 지정하는 다중선 맞춤설정 함수입니다. 이 함수를 FleetEngineTripLocationProviderOptions.activePolylineCustomization로 지정하여 활성 다중선에 대한 교통정보를 반영하는 다중선을 렌더링합니다.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
매개변수:
반환 값: 없음
속도 판독값에 따라 나머지 다중선의 색상을 지정하는 다중선 맞춤설정 함수입니다. 이 함수를 FleetEngineTripLocationProviderOptions.remainingPolylineCustomization로 지정하여 나머지 다중선에 대해 교통정보를 반영하는 다중선을 렌더링합니다.
tripId
유형: string
이 위치 제공자가 관찰하는 이동의 ID입니다. 추적을 시작하려면 이 필드를 설정하세요.
상속됨: isPolling, pollingIntervalMillis
refresh
refresh()
매개변수: 없음
반환 값: void
추적된 위치를 명시적으로 새로고침합니다.
상속됨: addListener
error
function(event)
인수:
위치 제공업체에 오류가 발생할 때 트리거되는 이벤트입니다.
update
function(event)
인수:
Fleet Engine 데이터 업데이트 요청이 완료되면 트리거되는 이벤트입니다.
상속됨: ispollingchange

FleetEngineTripLocationProviderOptions 인터페이스

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

여정 위치 제공업체 옵션입니다.
authTokenFetcher
클라이언트를 Fleet Engine에 인증하기 위한 JSON 웹 토큰을 제공합니다.
projectId
유형: string
Google Cloud 콘솔의 소비자 프로젝트 ID입니다.
activePolylineCustomization
선택사항
유형: (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
활성 다중선에 적용된 맞춤설정입니다. 활성 다중선은 차량이 현재 이동 중인 경로의 일부에 해당합니다.

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

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

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

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

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

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

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

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

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

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

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

    제공된 매개변수 및 용도 목록은 TripPolylineCustomizationFunctionParams를 참고하세요.
tripId
선택사항
유형: string optional
위치 정보 제공자가 인스턴스화된 직후 추적할 이동 ID입니다. 지정하지 않으면 위치 정보 제공자가 이동 추적을 시작하지 않습니다. FleetEngineTripLocationProvider.tripId를 사용하여 ID를 설정하고 추적을 시작하세요.
vehicleMarkerCustomization
선택사항
유형: (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
차량 마커에 적용된 맞춤설정입니다.

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

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

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

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

FleetEngineTripLocationProviderUpdateEvent 인터페이스

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

FleetEngineTripLocationProvider.update 이벤트가 트리거될 때 이벤트 핸들러에 전달되는 이벤트 객체입니다.
trip
선택사항
유형: Trip optional
업데이트에서 반환된 이동 구조입니다. 수정할 수 없습니다.