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

SDK Người tiêu dùng cho Android là một phần của Fleet Engine cho các chuyến đi theo yêu cầu. Thư viện này cung cấp các giao diện mô hình hoá dữ liệu chuyến đi và theo dõi chuyến đi trong Fleet Engine, cũng như các lớp để xây dựng màn hình hiển thị dựa trên bản đồ, chia sẻ tiến trình của chuyến đi (vị trí xe, tuyến đường, thời gian đến dự kiến, quãng đường còn lại, tình trạng giao thông) với người tiêu dùng trong một ứng dụng Android.

SDK Người tiêu dùng dành cho Android: thông tin chính

  • Sản phẩm: SDK Người tiêu dùng cho Android
  • Còn gọi là: SDK Người tiêu dùng Android, SDK Người tiêu dùng, SDK Người tiêu dùng Android cho chuyến đi theo yêu cầu của Dịch vụ di chuyển
  • 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 Người tiêu dùng cho Android

SDK Người tiêu dùng cho Android: trường hợp sử dụng

Sử dụng Consumer SDK cho Android khi:

  • Bạn cần người dùng trong ứng dụng Android của mình theo dõi một chuyến đi theo yêu cầu (chuyến đi, đơn đặt hàng hoặc giao hàng) mà phần phụ trợ của bạn theo dõi trong Fleet Engine.
  • Bạn cần hiển thị vị trí và tuyến đường gần với thời gian thực của một chiếc xe trên đường trong một ứng dụng Android dành cho người tiêu dùng.
  • Bạn cần cho biết thời gian đến dự kiến (ETA) của điểm đón và điểm trả khách, quãng đường còn lại và tình hình giao thông theo thời gian thực cho một chuyến đi trong Fleet Engine trên Android.
  • 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 đồ cho bản đồ chia sẻ hành trình trong Android.

Không sử dụng SDK Người tiêu dùng cho Android khi:

  • Bạn cần chia sẻ hành trình cho các chuyến đi theo yêu cầu trong một ứng dụng iOS. Hãy sử dụng SDK dành cho người tiêu dùng cho iOS.
  • Bạn cần chia sẻ hành trình trên một trang web hoặc theo dõi các nhiệm vụ đã lên lịch của người tiêu dùng, chẳng hạn như lô hàng. Hãy sử dụng JavaScript Consumer SDK.
  • 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 Android của tài xế. Thay vào đó, hãy sử dụng SDK Tài xế cho Android.

SDK Người tiêu dùng cho Android: thiết lập

Các gói SDK chính thức cho người tiêu dùng Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

SDK Người tiêu dùng cho Android: các lỗi thường gặp

  • Vấn đề: Nếu phần phụ thuộc SDK Maps không được đặt thành một phiên bản rõ ràng, thì SDK Người tiêu dùng sẽ sử dụng phiên bản SDK Maps tối thiểu bắt buộc. Điều này có thể làm hỏng các ứng dụng dựa vào các tính năng trong các phiên bản SDK Maps mới hơn. Cách khắc phục: Khai báo phiên bản play-services-maps được xác định rõ ràng cùng với transportation-consumer trong Gradle hoặc Maven. Xem /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • Vấn đề: Việc không dừng chia sẻ hành trình sau khi chuyến đi kết thúc sẽ gây ra các yêu cầu mạng không cần thiết đến Fleet Engine và rò rỉ bộ nhớ. Cách khắc phục: Gọi JourneySharingSession.stop() khi không cần chuyến đi nữa, ví dụ: trong onDestroy() hoặc khi chuyến đi là COMPLETE. Xem /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • Vấn đề: ConsumerApi.initialize() gửi một ngoại lệ nếu một thực thể API đã tồn tại (phiên bản 2.0.0 trở lên). Cách khắc phục: Trước tiên, hãy gọi ConsumerApi.getInstance() rồi kiểm tra Task được trả về để xác định xem một thực thể đã tồn tại hay chưa. Xem /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • Vấn đề: SDK Người tiêu dùng phiên bản 3 trở xuống không hỗ trợ chế độ R8 đầy đủ; các ứng dụng nhắm đến AGP 8.0 trở lên có thể gặp vấn đề về bản dựng hoặc thời gian chạy. Cách khắc phục: Đặt android.enableR8.fullMode=false khi nhắm mục tiêu AGP 8.0 trở lên và sử dụng AGP 7.3 trở lên với Kotlin 2.0 cho SDK người dùng theo yêu cầu 3.0 trở lên. Xem /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

SDK Người tiêu dùng cho Android: các tính năng cũ và không dùng nữa

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: Ngừng hoạt động kể từ ngày 15 tháng 9 năm 2023. Thay thế: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Xem hướng dẫn di chuyển.
  • Lớp Trip và chú thích Trip.TripStatus / Trip.TripType (và TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): Không dùng nữa kể từ ngày 15 tháng 9 năm 2023. Thay thế: TripInfo.TripStatus/TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Xem hướng dẫn di chuyển.
  • MarkerStyleOptions và PolylineStyleOptions: Ngừng hoạt động kể từ ngày 30/11/2021. Thay thế: MarkerOptions và PolylineOptions (dùng chung với SDK Maps). Triệu chứng: SDK Người tiêu dùng áp dụng kiểu mặc định riêng cho từng loại điểm đánh dấu hoặc hình nhiều đường, chứ không phải kiểu mặc định của MarkerOptions. Xem hướng dẫn di chuyển.
  • Kênh phân phối kho lưu trữ riêng tư: Không dùng nữa. Thay thế: Kho lưu trữ Maven của Google (phiên bản 2.1.0 trở lên). Xem hướng dẫn di chuyển.

Những việc bạn có thể làm với SDK Người tiêu dùng 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.