JavaScript Consumer SDK 빠른 참조

JavaScript Consumer SDK를 사용하면 웹 기반 소비자 앱에서 Fleet Engine에서 추적되는 차량 위치 및 기타 관심 위치를 지도에 표시할 수 있으므로 소비자가 주문형 이동 또는 예약된 배송의 진행 상황을 추적할 수 있습니다. Maps JavaScript API의 journeySharing 라이브러리로 로드됩니다.

JavaScript Consumer SDK: 주요 정보

  • 제품: JavaScript Consumer SDK
  • 다른 이름: JavaScript용 Consumer SDK, Mobility Services 주문형 이동 JavaScript, JavaScript SDK
  • 카테고리: 경로
  • 플랫폼: JavaScript(브라우저)
  • 실행 위치: 클라이언트(앱 또는 브라우저 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: JavaScript Consumer SDK 개요

JavaScript Consumer SDK: 사용 시기

다음과 같은 경우 JavaScript Consumer SDK를 사용하세요.

  • 웹페이지 또는 웹 앱에서 Fleet Engine이 추적하는 주문형 이동에 대한 차량의 실시간 위치와 경로를 소비자에게 표시해야 합니다.
  • 소비자가 브라우저에서 Fleet Engine에서 추적되는 예약된 배송의 수령 또는 배송 진행 상황을 추적할 수 있도록 해야 합니다.
  • 웹 기반 지도 뷰에서 이동 경로의 ETA, 남은 거리, 실시간 교통정보를 표시해야 합니다.
  • 웹 소비자 추적 뷰에서 이동 마커, 경로 다중선 또는 지도 스타일을 맞춤설정해야 합니다.

다음과 같은 경우에는 JavaScript Consumer SDK를 사용하지 마세요.

  • 네이티브 Android 앱 내에서 이동 추적 소비자 환경이 필요합니다. 대신 Android용 소비자 SDK를 사용하세요.
  • 네이티브 iOS 앱 내에서 이동 추적 소비자 환경이 필요합니다. 대신 iOS용 Consumer SDK를 사용하세요.
  • 운전자 Android 앱에서 Fleet Engine으로 운전자 위치와 이동 진행 상황을 보고해야 합니다. 대신 Android용 Driver SDK를 사용하세요.
  • 운전자 iOS 앱에서 Fleet Engine으로 운전자 위치와 이동 진행 상황을 보고해야 합니다. 대신 iOS용 Driver SDK를 사용하세요.
  • Fleet Engine 이동 또는 할 일을 따르지 않는 일반 웹 지도가 필요합니다. 대신 Maps JavaScript API를 사용하세요.

JavaScript Consumer SDK: 설정

자바스크립트 Consumer SDK: 일반적인 실수

  • 문제: JourneySharingMapView 지도에 초기 표시 영역(중심 및 확대/축소)을 지정하지 않으면 지도의 'ready' 이벤트가 실행되지 않을 수 있습니다. 해결 방법: 지도 뷰를 만든 후 mapView.map.setCenter(...) 및 mapView.map.setZoom(...)를 호출합니다. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey를 참고하세요.
  • 문제: 비동기 이동 정보 요청의 오류가 발생하지 않습니다. 위치 제공업체에 'error' 이벤트로만 도착하므로 리스너를 추가하지 않으면 알 수 없습니다. 해결 방법: locationProvider.addListener('error', ...)를 추가하고 라이브러리 호출을 try...catch 블록으로 래핑합니다. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey를 참고하세요.
  • 문제: journeySharing 라이브러리를 로드하지 않으면 google.maps.journeySharing 클래스를 사용할 수 없습니다. 해결 방법: Maps JavaScript API 스크립트 URL에 libraries=journeySharing를 추가하거나 await google.maps.importLibrary("journeySharing")를 사용하여 클래스를 로드합니다. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey를 참고하세요.
  • 문제: 브라우저(신뢰도가 낮은 환경)에서 Fleet Engine을 호출하려면 백엔드 서버에서 발급하는 JWT가 필요합니다. API 키만으로는 이동 데이터 액세스가 승인되지 않습니다. 해결 방법: 백엔드에서 JWT를 발급하고 토큰과 expiresInSeconds를 반환하는 authTokenFetcher를 제공합니다. /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup을 참고하세요.

JavaScript Consumer SDK: 기존 및 지원 중단된 기능

  • JourneySharingMapView 및 JourneySharingMapViewOptions 마커 및 다중선 설정 옵션(vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup 등): 지원 중단됨. 대체: 위치 제공자의 MarkerCustomizationFunction 및 PolylineCustomizationFunction 옵션(예: vehicleMarkerCustomization). 증상: 향후 출시에서 삭제될 예정입니다. 이전 가이드를 참고하세요.
  • JourneySharingMapView.locationProvider 및 JourneySharingMapViewOptions.locationProvider: 지원 중단됨. 대체: JourneySharingMapView.locationProviders 및 JourneySharingMapViewOptions.locationProviders
  • JourneySharingMapView 마커 및 다중선 목록 속성(vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines, 작업 마커 속성): 지원 중단됨. 대체: 위치 제공자의 MarkerCustomizationFunction 및 PolylineCustomizationFunction 콜백 이전 가이드를 참고하세요.

JavaScript Consumer SDK로 할 수 있는 작업

각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.