Tài liệu tham khảo nhanh về SDK trình điều khiển cho Android

Driver SDK cho Android là một bộ công cụ di động dành cho các ứng dụng của tài xế, giúp gửi thông tin cập nhật về vị trí xe, tuyến đường, quãng đường còn lại và thời gian đến dự kiến từ Navigation SDK đến Fleet Engine. Tính năng này hỗ trợ cả chuyến đi theo yêu cầu và nhiệm vụ theo lịch.

Driver SDK cho Android: thông tin chính

  • Sản phẩm: SDK Trình điều khiển cho Android
  • Còn gọi là: SDK trình điều khiển, SDK trình điều khiển cho chuyến đi theo yêu cầu, SDK trình điều khiển cho nhiệm vụ theo lịch
  • Danh mục: Tuyến đường
  • Nền tảng: Android
  • 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 trình điều khiển cho Android

SDK Tài xế cho Android: trường hợp sử dụng

Sử dụng SDK trình điều khiển cho Android khi:

  • Bạn cần có ứng dụng Android dành cho tài xế để gửi thông tin cập nhật về vị trí và tuyến đường của xe theo thời gian thực đến Fleet Engine.
  • Bạn cần có Fleet Engine để nhận thông tin về quãng đường còn lại và thời gian đến dự kiến (ETA) cho điểm tham chiếu tiếp theo từ SDK Điều hướng.
  • Bạn cần một ứng dụng dành cho tài xế để vừa quản lý các chuyến đi theo yêu cầu hoặc nhiệm vụ theo lịch trình được giao, vừa cung cấp thông tin chỉ đường.

Không sử dụng SDK Tài xế cho Android khi:

  • Bạn chỉ cần tính năng đường đi từng chặng trong ứng dụng và không sử dụng Fleet Engine. Hãy sử dụng Navigation SDK cho Android.
  • Bạn cần gửi thông tin cập nhật về dữ liệu của xe ngoài vị trí, tuyến đường, khoảng cách và thời gian đến dự kiến (những thông tin này được gửi qua phần phụ trợ của bạn). Hãy sử dụng Dịch vụ Fleet Engine.
  • Bạn tạo ứng dụng dành cho tài xế cho iOS. Hãy sử dụng Driver SDK cho iOS.

SDK trình điều khiển cho Android: thiết lập

Các gói SDK chính thức cho tài xế trên Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

SDK Trình điều khiển cho Android: các lỗi thường gặp

  • Vấn đề: Nếu các phần phụ thuộc của bản dựng không chỉ định phiên bản SDK trình điều khiển, thì IDE sẽ tải phiên bản mới nhất; kể từ phiên bản 7.0.0, các bản dựng mới không còn hỗ trợ Android 6 và 7 (API 23-25). Cách khắc phục: Chỉ định rõ phiên bản Driver SDK cho Android trong các phần phụ thuộc của bản dựng để kiểm soát thời điểm thay đổi hệ điều hành tối thiểu được hỗ trợ. Xem /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
  • Vấn đề: SDK trình điều khiển phụ thuộc vào SDK điều hướng; nếu không có phiên bản SDK điều hướng được ghim, dự án sẽ luôn tải SDK điều hướng mới nhất xuống trong phiên bản chính. Cách khắc phục: Thêm cả phần phụ thuộc SDK trình điều khiển và SDK điều hướng. Nếu bạn ghim SDK Điều hướng, hãy chọn một phiên bản trong phạm vi mà ghi chú phát hành liệt kê cho phiên bản SDK Trình điều khiển của bạn (ví dụ: [7.0, 8.0) cho SDK Trình điều khiển 7.1). Xem /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
  • Vấn đề: SDK yêu cầu mã thông báo uỷ quyền thông qua AuthTokenFactory tại thời điểm cập nhật vị trí; nếu máy chủ của bạn không thể phát hành JWT, thì các bản cập nhật cho Fleet Engine sẽ không được uỷ quyền. Cách khắc phục: Đảm bảo rằng quá trình triển khai phía máy chủ có thể phát hành mã thông báo trước khi khởi chạy SDK và sử dụng lại mã thông báo cho đến khi hết hạn. Xem /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate.
  • Vấn đề: Bản dựng ProGuard có thể đưa ra cảnh báo cho các lớp com.google, io.grpc và okio. Cách khắc phục: Thêm -dontwarn com.google.**, -dontwarn io.grpc.** và -dontwarn okio.** vào cấu hình ProGuard. Xem /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.

SDK Trình điều khiển cho Android: các tính năng cũ và không dùng nữa

  • Giao diện StatusListener: Ngừng hoạt động kể từ ngày 25/11/2024. Thay thế: DriverStatusListener. Triệu chứng: Đã bị loại bỏ trong SDK Tài xế cho Android phiên bản 6.0.0. Xem hướng dẫn di chuyển.
  • SDK Điều hướng/Tài xế cho Android phiên bản 1.x (tệp nhị phân kết hợp): Ngừng hoạt động kể từ ngày 21 tháng 6 năm 2022. Thay thế: Tách riêng tệp nhị phân của SDK điều hướng và SDK trình điều khiển phiên bản 3 trở lên. Triệu chứng: Ngừng hoạt động từ ngày 21/6/2021 và không được duy trì sau ngày 21/6/2022; các phương thức như Waypoint#fromLatLng và Navigator#startGuidance(resumeIntent) đã bị xoá trong phiên bản 3.0. Xem hướng dẫn di chuyển.
  • AuthTokenContext ServiceType: Ngừng hoạt động kể từ ngày 29/11/2021. Thay thế: Thông báo xác nhận quyền sở hữu cho mã nhận dạng xe và mã nhận dạng nhiệm vụ được cung cấp. Triệu chứng: Đã xoá trong phiên bản 4.0.0: ServiceType và getServiceType() khỏi AuthTokenContext, và setServiceType khỏi AuthTokenContext.Builder. Xem hướng dẫn di chuyển.
  • Thuộc tính Task parentId: Không còn được dùng kể từ ngày 28/4/2022. Thay thế: trackingId. Triệu chứng: Đã đổi tên trong phiên bản 4.1.0; thuộc tính cũ vẫn tồn tại nhưng không được dùng nữa.

Những việc bạn có thể làm với SDK Tài xế cho Android

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.