JavaScript Consumer SDK 可讓網頁式消費者應用程式在地圖上顯示車輛位置,以及 Fleet Engine 追蹤的其他興趣點,方便消費者追蹤隨選行程或排定運送作業的進度。載入時,會成為 Maps JavaScript API 的 journeySharing 程式庫。
JavaScript Consumer SDK:重要資訊
- 產品:JavaScript Consumer SDK
- 別名:Consumer SDK for JavaScript、Mobility Services 隨選行程 JavaScript、JavaScript SDK
- 類別:路徑
- 平台:JavaScript (瀏覽器)
- 執行位置:用戶端 (應用程式或瀏覽器程式碼)
- 推出階段:GA
- 生命週期:有效
- 總覽:JavaScript Consumer SDK 總覽
JavaScript Consumer SDK:適用時機
JavaScript Consumer SDK 適用於:
- 您需要在網頁或網頁應用程式中,向消費者顯示車輛的即時位置和路線,以便追蹤 Fleet Engine 的隨選行程。
- 您需要讓消費者在瀏覽器中,追蹤 Fleet Engine 追蹤的預定運送作業的取貨或送達進度。
- 您需要在網頁式地圖檢視畫面中,顯示行程的預計到達時間、剩餘距離和即時路況。
- 您需要在網頁消費者追蹤檢視畫面中,自訂行程標記、路線折線或地圖樣式。
在下列情況下,請勿使用 JavaScript Consumer SDK:
- 您需要在原生 Android 應用程式中提供行程追蹤消費者體驗。請改用 Consumer SDK for Android。
- 您需要在原生 iOS 應用程式中提供行程追蹤消費者體驗。請改用 Consumer SDK for iOS。
- 您必須將司機位置和行程進度,從司機的 Android 應用程式回報給 Fleet Engine。請改用 Driver SDK for Android。
- 您必須透過司機的 iOS 應用程式,向 Fleet Engine 回報司機位置和行程進度。請改用 Driver SDK for iOS。
- 您需要不追蹤 Fleet Engine 行程或任務的一般網路地圖。請改用 Maps JavaScript API。
JavaScript Consumer SDK:設定
- 驗證:API 金鑰、JSON Web Token (JWT)
- 同時啟用:Maps JavaScript API、Fleet Engine Service
- 用量歸因:選用 (Beta 版) Mobility 交易 ID:建立
JourneySharingMapView前,請將google.maps.Settings.getInstance().experienceIds設為 Mobility 交易 ID (或相關 ID) 陣列。experienceIds僅適用於 Maps JavaScript API 的v=beta管道。 - 開始使用:設定 JavaScript Consumer SDK
- 參考資料:JavaScript Consumer SDK 參考資料
- 版本資訊:JavaScript Consumer SDK 版本資訊
JavaScript Consumer SDK:相關產品
JavaScript 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 指令碼網址中加入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等):已淘汰。替代方案:位置供應器 (例如vehicleMarkerCustomization) 上的MarkerCustomizationFunction和PolylineCustomizationFunction選項。症狀:預計在日後版本中移除。請參閱遷移指南。JourneySharingMapView.locationProvider和JourneySharingMapViewOptions.locationProvider:已淘汰。替代方案:JourneySharingMapView.locationProviders和JourneySharingMapViewOptions.locationProviders。JourneySharingMapView標記和折線清單屬性 (vehicleMarkers、originMarkers、destinationMarkers、waypointMarkers、anticipatedRoutePolylines、takenRoutePolylines和工作標記屬性):已淘汰。替代方案:位置供應器的MarkerCustomizationFunction和PolylineCustomizationFunction回呼。請參閱遷移指南。
JavaScript Consumer SDK 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 在網頁或行動應用程式的地圖上,新增追蹤車輛引擎行程的路線折線。
- 在網頁或行動應用程式的地圖上,更新 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 的行程進度。