SDK JavaScript dành cho người dùng cho phép ứng dụng chạy trên nền tảng web dành cho người dùng hiển thị vị trí của xe và các vị trí quan tâm khác được theo dõi trong Fleet Engine trên bản đồ, nhờ đó, người dùng có thể theo dõi tiến trình của một chuyến đi theo yêu cầu hoặc một chuyến hàng theo lịch trình. Thư viện này được tải dưới dạng thư viện journeySharing của Maps JavaScript API.
SDK JavaScript cho người dùng: thông tin chính
- Sản phẩm: SDK JavaScript cho người tiêu dùng
- Còn được gọi là: SDK Người tiêu dùng cho JavaScript, JavaScript cho chuyến đi theo yêu cầu của dịch vụ di chuyển, SDK JavaScript
- Danh mục: Tuyến đường
- Nền tảng: JavaScript (trình duyệt)
- Chạy trên: Ứng dụng khách (mã ứng dụng hoặc trình duyệt)
- Giai đoạn ra mắt: GA
- Vòng đời: Đang hoạt động
- Tổng quan: Tổng quan về SDK JavaScript cho người tiêu dùng
SDK Người tiêu dùng JavaScript: trường hợp sử dụng
Sử dụng SDK JavaScript cho người tiêu dùng khi:
- Bạn cần cho người tiêu dùng thấy vị trí và tuyến đường theo thời gian thực của một chiếc xe trong một chuyến đi theo yêu cầu mà Fleet Engine theo dõi, trên một trang web hoặc ứng dụng web.
- Bạn cần cho phép người tiêu dùng theo dõi tiến trình lấy hàng hoặc giao hàng của một lô hàng theo lịch được theo dõi trong Công cụ quản lý đội xe trên trình duyệt.
- Bạn cần hiển thị thời gian đến dự kiến, quãng đường còn lại và tình hình giao thông theo thời gian thực trên tuyến đường của một chuyến đi trong chế độ xem bản đồ trên web.
- Bạn cần tuỳ chỉnh điểm đánh dấu chuyến đi, hình nhiều đường của tuyến đường hoặc kiểu bản đồ trong chế độ xem theo dõi của người dùng trên web.
Không sử dụng SDK Người tiêu dùng JavaScript khi:
- Bạn cần có trải nghiệm theo dõi chuyến đi cho người tiêu dùng trong một ứng dụng Android gốc. Hãy sử dụng SDK dành cho người tiêu dùng cho Android.
- Bạn cần có trải nghiệm theo dõi chuyến đi cho người tiêu dùng trong một ứng dụng iOS gốc. Hãy sử dụng SDK Người tiêu dùng cho iOS.
- Bạn cần báo cáo vị trí của tài xế và tiến trình của chuyến đi từ ứng dụng Android của tài xế cho Fleet Engine. Hãy sử dụng Driver SDK cho Android.
- Bạn cần báo cáo vị trí của tài xế và tiến trình chuyến đi từ ứng dụng iOS của tài xế cho Fleet Engine. Hãy sử dụng Driver SDK cho iOS.
- Bạn cần một bản đồ web chung không theo dõi các chuyến đi hoặc nhiệm vụ của Fleet Engine. Thay vào đó, hãy sử dụng Maps JavaScript API.
JavaScript Consumer SDK: thiết lập
- Xác thực: Khoá API, Mã thông báo web JSON (JWT)
- Cũng bật: Maps JavaScript API, Dịch vụ Fleet Engine
- Phân bổ mức sử dụng: Mã giao dịch di động không bắt buộc (thử nghiệm): đặt
google.maps.Settings.getInstance().experienceIdsthành một mảng Mã giao dịch di động (hoặc mã nhận dạng có liên quan) trước khi bạn tạoJourneySharingMapView.experienceIdschỉ có trong kênhv=betacủa Maps JavaScript API. - Bắt đầu: Thiết lập SDK JavaScript cho người tiêu dùng
- Tài liệu tham khảo: Tài liệu tham khảo về SDK Người tiêu dùng JavaScript
- Ghi chú phát hành: Ghi chú phát hành SDK JavaScript cho người tiêu dùng
JavaScript Consumer SDK: related products
- Thường dùng với: Dịch vụ Fleet Engine, Maps JavaScript API, Driver SDK cho Android, Driver SDK cho iOS
JavaScript Consumer SDK: các lỗi thường gặp
- Vấn đề: Nếu bạn không cung cấp cho bản đồ
JourneySharingMapViewmột khung nhìn ban đầu (tâm và mức thu phóng), thì sự kiện'ready'của bản đồ có thể không kích hoạt. Cách khắc phục: GọimapView.map.setCenter(...)vàmapView.map.setZoom(...)sau khi bạn tạo chế độ xem bản đồ. Xem /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Vấn đề: Lỗi từ các yêu cầu thông tin chuyến đi không đồng bộ không được gửi. Các sự kiện này chỉ đến dưới dạng sự kiện
'error'trên trình cung cấp vị trí, vì vậy, chúng sẽ không được chú ý trừ phi bạn thêm trình nghe. Cách khắc phục: ThêmlocationProvider.addListener('error', ...)và gói các lệnh gọi thư viện trong khốitry...catch. Xem /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Vấn đề: Các lớp
google.maps.journeySharingkhông hoạt động trừ phi bạn tải thư việnjourneySharing. Cách khắc phục: Thêmlibraries=journeySharingvào URL tập lệnh của API JavaScript cho Maps hoặc tải các lớp bằngawait google.maps.importLibrary("journeySharing"). Xem /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Vấn đề: Các lệnh gọi Fleet Engine từ trình duyệt (môi trường có độ tin cậy thấp) cần có JWT do máy chủ phụ trợ của bạn phát hành. Chỉ riêng khoá API thì không cho phép truy cập vào dữ liệu chuyến đi. Cách khắc phục: Phát hành JWT từ phần phụ trợ và cung cấp một
authTokenFetchertrả về mã thông báo vàexpiresInSeconds. Xem /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.
SDK JavaScript cho người tiêu dùng: các tính năng cũ và không dùng nữa
- Các lựa chọn thiết lập điểm đánh dấu và hình nhiều đường
JourneySharingMapViewvàJourneySharingMapViewOptions(vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupvà các lựa chọn khác): Không dùng nữa. Thay thế: Các tuỳ chọnMarkerCustomizationFunctionvàPolylineCustomizationFunctiontrên trình cung cấp thông tin vị trí (ví dụ:vehicleMarkerCustomization). Triệu chứng: Dự kiến sẽ bị xoá trong bản phát hành sau này. Xem hướng dẫn di chuyển. JourneySharingMapView.locationProvidervàJourneySharingMapViewOptions.locationProvider: Không dùng nữa. Thay thế:JourneySharingMapView.locationProvidersvàJourneySharingMapViewOptions.locationProviders.- Thuộc tính danh sách điểm đánh dấu và hình nhiều đường
JourneySharingMapView(vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinesvà thuộc tính điểm đánh dấu nhiệm vụ): Không dùng nữa. Thay thế: Lệnh gọi lạiMarkerCustomizationFunctionvàPolylineCustomizationFunctiontrên trình cung cấp vị trí. Xem hướng dẫn di chuyển.
Những việc bạn có thể làm với SDK JavaScript cho người tiêu dùng
Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.
- Thêm một hình nhiều đường cho tuyến đường để theo dõi chuyến đi từ Fleet Engine đến bản đồ trên trang web hoặc ứng dụng di động.
- Cập nhật tiến trình của chuyến đi dọc theo một tuyến đường trên bản đồ trong trang web hoặc ứng dụng di động cho một chuyến đi trong Fleet Engine.
- Thay đổi kiểu đường, hình nhiều đường và đa giác trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Hiển thị hoặc ẩn các đối tượng trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Thay đổi kiểu biểu tượng và nhãn văn bản trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Áp dụng các kiểu bản đồ khác nhau cho các mức thu phóng khác nhau trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Thay đổi mật độ địa điểm trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Kiểu bản đồ dựa trên đám mây trong SDK Người tiêu dùng đã được phát hành rộng rãi, trong khi tính năng kiểm soát mật độ địa điểm yêu thích là một tính năng Kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên kiểu bản đồ sáng).
- Thay đổi kiểu của toà nhà trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Kiểu bản đồ dựa trên đám mây trong SDK Người tiêu dùng đã được phát hành rộng rãi, trong khi tính năng tuỳ chỉnh kiểu toà nhà 3D và dấu chân là một tính năng Kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên kiểu bản đồ sáng).
- Thay đổi kiểu của các địa danh trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine. Thử nghiệm Lưu ý: Tính năng hỗ trợ Tạo kiểu bản đồ dựa trên đám mây trong SDK Người tiêu dùng đã được phát hành rộng rãi, trong khi tính năng tuỳ chỉnh biểu tượng địa danh là một tính năng Tạo kiểu bản đồ dựa trên đám mây thử nghiệm (chỉ được hỗ trợ trên các kiểu bản đồ sáng).
- Tuỳ chỉnh điểm đánh dấu trên bản đồ để theo dõi tiến trình của một chuyến đi từ Fleet Engine.
- Tuỳ chỉnh hình nhiều đường của tuyến đường trên bản đồ theo dõi tiến trình của một chuyến đi từ Fleet Engine.