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
- Xác thực: Khoá API, Mã thông báo web JSON (JWT)
- Cũng bật: Maps SDK cho Android
- Bắt đầu: Thiết lập SDK Tài xế cho Android
- Tài liệu tham khảo: Tài liệu tham khảo về SDK trình điều khiển cho Android
- Chính sách: Chính sách về SDK Tài xế cho Android
- Ghi chú phát hành: Ghi chú phát hành SDK trình điều khiển cho Android
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
Driver SDK cho Android: sản phẩm có liên quan
- Thường dùng với: SDK Điều hướng cho Android, Dịch vụ Fleet Engine
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
AuthTokenFactorytạ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.grpcvà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#fromLatLngvàNavigator#startGuidance(resumeIntent)đã bị xoá trong phiên bản 3.0. Xem hướng dẫn di chuyển. AuthTokenContextServiceType: 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:ServiceTypevàgetServiceType()khỏiAuthTokenContext, vàsetServiceTypekhỏiAuthTokenContext.Builder. Xem hướng dẫn di chuyển.- Thuộc tính
TaskparentId: 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.
- Báo cáo vị trí theo thời gian thực của xe cho dịch vụ Fleet Engine.
- Báo cáo toạ độ vĩ độ/kinh độ của các điểm tham chiếu trong chuyến đi của xe từ SDK Điều hướng đến dịch vụ Fleet Engine.
- Báo cáo quãng đường còn lại của xe đến điểm tham chiếu tiếp theo cho dịch vụ Fleet Engine.
- Báo cáo thời gian đến dự kiến của một chiếc xe tại điểm tham chiếu tiếp theo cho dịch vụ Fleet Engine.
- Báo cáo tuyến đường do SDK Điều hướng cung cấp cho một xe đến dịch vụ Fleet Engine.