Fleet Tracking - On Demand Rides & Delivery

FleetEngineVehicleLocationProvider 클래스

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

차량 위치 정보 제공자

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

FleetEngineVehicleLocationProviderOptions 인터페이스

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

차량 위치 정보 제공업체 옵션입니다.

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

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

    제공된 매개변수 및 용도 목록은 VehiclePolylineCustomizationFunctionParams를 참고하세요.
destinationMarkerCustomization
선택사항
차량 이동 목적지 마커에 적용된 맞춤설정입니다.

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

    제공된 매개변수 및 용도 목록은 VehicleWaypointMarkerCustomizationFunctionParams를 참고하세요.
intermediateDestinationMarkerCustomization
선택사항
차량 이동 중간 목적지 마커에 적용된 맞춤설정입니다.

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

    제공된 매개변수 및 용도 목록은 VehicleWaypointMarkerCustomizationFunctionParams를 참고하세요.
originMarkerCustomization
선택사항
차량 이동 출발지 마커에 적용된 맞춤설정입니다.

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

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

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

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

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

    제공된 매개변수 및 용도 목록은 VehiclePolylineCustomizationFunctionParams를 참고하세요.
staleLocationThresholdMillis
선택사항
유형: number optional
오래된 차량 위치의 기준입니다. 차량의 마지막 업데이트 위치가 이 기준보다 오래된 경우 차량이 표시되지 않습니다. 기본값은 24시간(밀리초)입니다. 기준점이 0보다 작거나 무한대인 경우 기준점은 무시되고 차량 위치는 오래된 것으로 간주되지 않습니다.
takenPolylineCustomization
선택사항
사용된 다중선에 적용된 맞춤설정입니다. 이동한 다중선은 차량이 이미 이동한 경로의 일부에 해당합니다.

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

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

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

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

FleetEngineVehicleLocationProviderUpdateEvent 인터페이스

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

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

trips
선택사항
유형: Array<Trip> optional
이 차량에서 완료한 이동 목록입니다. 수정할 수 없습니다.
vehicle
선택사항
유형: Vehicle optional
업데이트에서 반환된 차량 데이터 구조입니다. 수정할 수 없습니다.

FleetEngineFleetLocationProvider 클래스

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

Fleet 위치 정보 제공자

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
매개변수:
Fleet Engine에서 추적하는 차량의 새 위치 정보 제공자를 만듭니다.
locationRestriction
차량을 추적할 경계입니다. 경계가 설정되지 않으면 차량이 추적되지 않습니다. 위치와 관계없이 모든 차량을 추적하려면 지구 전체에 해당하는 경계를 설정합니다.
staleLocationThresholdMillis
유형: number
이 필드는 읽기 전용입니다. 오래된 차량 위치의 기준입니다. 차량의 마지막 업데이트 위치가 이 기준보다 오래된 경우 차량이 표시되지 않습니다.
vehicleFilter
유형: string optional
차량을 가져올 때 적용되는 필터입니다.
상속됨: isPolling, pollingIntervalMillis
상속됨: addListener
update
function(event)
Fleet Engine 데이터 업데이트 요청이 완료되면 트리거되는 이벤트입니다.
상속됨: ispollingchange

FleetEngineFleetLocationProviderOptions 인터페이스

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

Fleet Location Provider 옵션입니다.

authTokenFetcher
클라이언트를 Fleet Engine에 인증하기 위한 JSON 웹 토큰을 제공합니다.
projectId
유형: string
Google Cloud 콘솔의 소비자 프로젝트 ID입니다.
locationRestriction
선택사항
위치 제공자가 인스턴스화된 직후 차량을 추적할 위도/경도 경계입니다. 설정하지 않으면 위치 정보 제공자가 차량 추적을 시작하지 않습니다. FleetEngineFleetLocationProvider.locationRestriction를 사용하여 경계를 설정하고 추적을 시작하세요. 위치와 관계없이 모든 차량을 추적하려면 지구 전체에 해당하는 경계를 설정합니다.
staleLocationThresholdMillis
선택사항
유형: number optional
오래된 차량 위치의 기준입니다. 차량의 마지막 업데이트 위치가 이 기준보다 오래된 경우 차량이 표시되지 않습니다. 기본값은 24시간(밀리초)입니다. 기준점이 0 미만이거나 무한대인 경우 기준점은 무시되고 차량 위치는 오래된 것으로 간주되지 않습니다.
vehicleFilter
선택사항
유형: string optional
차량을 가져올 때 적용할 필터 쿼리입니다. 이 필터는 Fleet Engine에 직접 전달됩니다.

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

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

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

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

FleetEngineFleetLocationProviderUpdateEvent 인터페이스

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

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

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