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: 설정
- 인증: API 키, JSON 웹 토큰(JWT)
- 사용 설정해야 하는 추가 API: Maps JavaScript API, Fleet Engine Service
- 사용 속성: 선택사항(베타) 이동성 거래 ID:
JourneySharingMapView를 만들기 전에google.maps.Settings.getInstance().experienceIds를 이동성 거래 ID(또는 관련 ID) 배열로 설정합니다.experienceIds는 Maps JavaScript API의v=beta채널에서만 사용할 수 있습니다. - 시작하기: JavaScript Consumer SDK 설정
- 참조: JavaScript Consumer SDK 참조
- 출시 노트: JavaScript Consumer SDK 출시 노트
JavaScript Consumer SDK: 관련 상품
- 함께 자주 사용되는 제품: Fleet Engine 서비스, Maps JavaScript API, Android용 Driver SDK, iOS용 Driver 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.locationProvidersJourneySharingMapView마커 및 다중선 목록 속성(vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylines, 작업 마커 속성): 지원 중단됨. 대체: 위치 제공자의MarkerCustomizationFunction및PolylineCustomizationFunction콜백 이전 가이드를 참고하세요.
JavaScript Consumer SDK로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- Fleet Engine에서 웹페이지 또는 모바일 앱의 지도로 이동을 추적하는 경로 다중선을 추가합니다.
- Fleet Engine 이동을 위해 웹페이지 또는 모바일 앱의 지도에서 경로를 따라 이동 진행 상황을 업데이트합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 도로, 다중선, 다각형의 스타일을 변경합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에 지도 지형지물을 표시하거나 숨깁니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도의 아이콘 및 텍스트 라벨 스타일을 변경합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 확대/축소 수준에 따라 다양한 지도 스타일을 적용합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 장소의 밀도를 변경합니다. 실험용 참고: Consumer SDK의 클라우드 기반 지도 스타일 지정 지원은 정식 버전이지만 관심 장소 밀도 제어는 실험용 클라우드 기반 지도 스타일 지정 기능입니다(밝은 지도 스타일에서만 지원됨).
- Fleet Engine에서 이동 진행 상황을 추적하는 지도의 건물 스타일을 변경합니다. 실험용 참고: Consumer SDK의 클라우드 기반 지도 스타일 지정 지원은 정식 버전이지만 3D 및 풋프린트 건물 스타일 맞춤설정은 실험용 클라우드 기반 지도 스타일 지정 기능입니다(밝은 지도 스타일에서만 지원됨).
- Fleet Engine에서 이동 진행 상황을 추적하는 지도의 명소 스타일을 변경합니다. 실험용 참고: Consumer SDK의 클라우드 기반 지도 스타일 지정 지원은 정식 버전이지만, 명소 아이콘 맞춤설정은 실험용 클라우드 기반 지도 스타일 지정 기능입니다(밝은 지도 스타일에서만 지원됨).
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 마커를 맞춤설정합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 경로 다중선을 맞춤설정합니다.