Tài liệu tham khảo nhanh về SDK Người tiêu dùng JavaScript

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

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 đồ JourneySharingMapView mộ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ọi mapView.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êm locationProvider.addListener('error', ...) và gói các lệnh gọi thư viện trong khối try...catch. Xem /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Vấn đề: Các lớp google.maps.journeySharing không hoạt động trừ phi bạn tải thư viện journeySharing. Cách khắc phục: Thêm libraries=journeySharing vào URL tập lệnh của API JavaScript cho Maps hoặc tải các lớp bằng await 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 authTokenFetcher trả 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 JourneySharingMapView và JourneySharingMapViewOptions (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup và các lựa chọn khác): Không dùng nữa. Thay thế: Các tuỳ chọn MarkerCustomizationFunction và PolylineCustomizationFunction trê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.locationProvider và JourneySharingMapViewOptions.locationProvider: Không dùng nữa. Thay thế: JourneySharingMapView.locationProviders và 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, takenRoutePolylines và 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ại MarkerCustomizationFunction và PolylineCustomizationFunction trê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.