Fleet Tracking - On Demand Rides & Delivery (beta)

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)
매개변수: 
반환 값:  없음
속도 판독값에 따라 활성 다중선의 색상을 지정하는 다중선 맞춤설정 함수입니다. 이 함수를 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 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 콘솔의 소비자 프로젝트 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
쿼리에서 반환된 차량 목록입니다. 수정할 수 없습니다.