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 또는 Infinity 미만인 경우 임곗값은 무시되고 차량 위치가 비활성으로 간주되지 않습니다.
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 인터페이스

Fleet 위치 제공업체 옵션입니다.

authTokenFetcher
Fleet Engine에 클라이언트를 인증하기 위한 JSON 웹 토큰을 제공합니다.
projectId
유형:  string
Google Cloud 콘솔의 소비자의 프로젝트 ID
locationRestriction optional
위치 제공자가 인스턴스화된 직후 차량을 추적하기 위한 위도/경도 경계입니다. 설정하지 않으면 위치 정보 제공자가 차량 추적을 시작하지 않습니다. FleetEngineFleetLocationProvider.locationRestriction를 사용하여 경계를 설정하고 추적을 시작합니다. 위치에 관계없이 모든 차량을 추적하려면 지구 전체와 동일한 경계를 설정합니다.
staleLocationThresholdMillis optional
유형:  number optional
오래된 차량 위치의 기준입니다. 차량의 마지막으로 업데이트된 위치가 이 임계값보다 오래된 경우 차량이 표시되지 않습니다. 기본값은 24시간(밀리초)입니다. 임계값이 0보다 작거나 Infinity이면 임계값이 무시되고 차량 위치가 비활성으로 간주되지 않습니다.
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
쿼리에서 반환된 차량 목록입니다. 수정할 수 없습니다.