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
- Xác thực: Mã thông báo web JSON (JWT), khoá API
- Đồng thời bật: Dịch vụ Fleet Engine, Maps SDK cho Android
- Bắt đầu: Thiết lập Consumer SDK cho Android
- Tài liệu tham khảo: Tài liệu tham khảo về SDK người tiêu dùng cho Android
- Chính sách: Chính sách về SDK người tiêu dùng cho Android
- Ghi chú phát hành: Ghi chú phát hành SDK Người tiêu dùng cho Android
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
Consumer SDK cho Android: sản phẩm có liên quan
- Thường dùng với: Dịch vụ Fleet Engine, Driver SDK cho Android, Maps SDK cho Android
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ớitransportation-consumertrong 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ụ: trongonDestroy()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ọiConsumerApi.getInstance()rồi kiểm traTaskđượ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=falsekhi 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
Tripvà chú thíchTrip.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. MarkerStyleOptionsvàPolylineStyleOptions: Ngừng hoạt động kể từ ngày 30/11/2021. Thay thế:MarkerOptionsvà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ủaMarkerOptions. 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.
- Thêm một bản đồ tương tác, có thể tuỳ chỉnh để theo dõi tiến trình của một chuyến đi từ Fleet Engine đến một ứng dụng di độ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.