Fleet Tracking - On Demand Rides & Delivery

FleetEngineVehicleLocationProvider 클래스

google.maps.journeySharing.FleetEngineVehicleLocationProvider 클래스

차량 위치 정보 제공자입니다.

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

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
매개변수: 
Fleet Engine 차량의 새 위치 제공자를 만듭니다.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
매개변수: 
반환 값:  None
속도 읽기에 따라 활성 다중선에 색상을 지정하는 다중선 맞춤설정 기능 이 함수를 FleetEngineVehicleLocationProviderOptions.activePolylineCustomization로 지정하여 활성 다중선에 교통 상황을 고려한 다중선을 렌더링합니다.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
매개변수: 
반환 값:  None
속도 읽기에 따라 나머지 다중선에 색상을 지정하는 다중선 맞춤설정 함수 이 함수를 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 Console의 소비자 프로젝트 ID입니다.
activePolylineCustomization optional
유형:  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
활성 다중선에 적용된 맞춤설정입니다. 활성 다중선은 차량이 현재 통과하는 경로의 일부에 해당합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    제공된 매개변수와 그 사용 목록은 VehicleMarkerCustomizationFunctionParams를 참고하세요.

FleetEngineVehicleLocationProviderUpdateEvent 인터페이스

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

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

trips optional
유형:  Array<Trip> optional
이 차량으로 완료된 이동 목록입니다. 수정할 수 없습니다.
vehicle optional
유형:  Vehicle optional
업데이트에 의해 반환된 차량 데이터 구조입니다. 수정할 수 없습니다.

FleetEngineFleetLocationProvider 클래스

google.maps.journeySharing.FleetEngineFleetLocationProvider 클래스

Fleet 위치 정보 제공자입니다.

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

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

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 인터페이스

차량 위치 제공자의 옵션입니다.

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

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

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

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

    제공된 매개변수와 그 사용 목록은 VehicleMarkerCustomizationFunctionParams를 참고하세요.

FleetEngineFleetLocationProviderUpdateEvent 인터페이스

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

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

vehicles optional
유형:  Array<Vehicle> optional
쿼리로 반환된 차량 목록입니다. 수정할 수 없습니다.