Điều chỉnh trải nghiệm của người tiêu dùng cho các chuyến đi theo yêu cầu bằng cách cho phép người tiêu dùng theo dõi chuyến đi đối với đơn đặt hàng, chuyến đi hoặc dịch vụ khác mà bạn cung cấp cho họ.
Consumer SDK là gì?
SDK Người tiêu dùng 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, đồng thời cung cấp các lớp mà bạn dùng để tạo màn hình hiển thị phong phú, dựa trên bản đồ để chia sẻ hành trình với người dùng là người tiêu dùng. Bạn tích hợp SDK Người tiêu dùng vào ứng dụng của mình và đặt hồ sơ vai trò thích hợp trong Fleet Engine để tạo trải nghiệm này cho người tiêu dùng.
Các API dành riêng cho nền tảng của Consumer SDK cho phép bạn tạo khả năng chia sẻ hành trình một cách tự nhiên vào các ứng dụng của mình. Consumer SDK có sẵn cho các nền tảng sau:
Tại sao nên sử dụng Consumer SDK?
Việc tích hợp SDK Người tiêu dùng vào các ứng dụng chuyến đi theo yêu cầu giúp bạn mang đến trải nghiệm toàn diện cho người tiêu dùng, với thông báo cập nhật vị trí gần như theo thời gian thực và vị trí được điều chỉnh theo đường đi. Người tiêu dùng có thể xem tuyến đường của xe được phủ lên trên bản đồ, bao gồm cả thông tin chi tiết về tiến trình giúp họ biết được chuyến đi hoặc hoạt động giao hàng của mình đang ở đâu.
Bạn có thể làm gì với Consumer SDK?
Bạn có thể sử dụng thông tin từ SDK trình điều khiển và Công cụ quản lý đội xe để tạo trải nghiệm tuỳ chỉnh cho người tiêu dùng, bao gồm các tính năng sau:
Tuỳ chỉnh giao diện người dùng của bản đồ cho phù hợp với nhu cầu xây dựng thương hiệu của bạn.
Theo dõi vị trí hiện tại của xe khi xe di chuyển dọc theo tuyến đường, với vị trí được cập nhật định kỳ.
Hiển thị thời gian đến dự kiến (ETA) cho các địa điểm đón và trả khách.
Hiện khoảng cách còn lại.
Hiển thị tình hình giao thông theo thời gian thực trên tuyến đường.
Cách hoạt động của Consumer SDK
Nhìn chung, SDK Người tiêu dùng dựa vào các cơ chế sau:
- Có các vai trò phù hợp trong Fleet Engine để một ứng dụng đã xác thực có thể theo dõi chuyến đi liên quan đến đơn đặt hàng của người tiêu dùng.
- Mối liên kết giữa người tiêu dùng và chuyến đi, do hệ thống phụ trợ của bạn cung cấp.
- Các lớp SDK
TripModelvàJourneySharingSessiontạo mô hình dữ liệu chuyến đi và chia sẻ phiên chuyến đi trong ứng dụng của người tiêu dùng.
SDK Người tiêu dùng cũng cung cấp các giao diện và lớp khác để bạn có thể tạo trải nghiệm ứng dụng phong phú, hoàn chỉnh với các thông tin chi tiết như tình hình giao thông, điểm đánh dấu trên bản đồ, thời gian đến dự kiến và dữ liệu tuyến đường.
Bảng này cho thấy quy trình của một chuyến đi mà ứng dụng dành cho người tiêu dùng theo dõi.
| 1 | Ứng dụng của người tiêu dùng yêu cầu một chuyến đi | Máy chủ phụ trợ của bạn nhận được một yêu cầu chuyến đi theo yêu cầu và thực hiện những việc sau:
|
| 2 | Tài xế chấp nhận chuyến đi | Ứng dụng dành cho tài xế nhận được mã chuyến đi và thông tin chuyến đi, sau đó tài xế chấp nhận chuyến đi. |
| 3 | Ứng dụng dành cho người tiêu dùng yêu cầu quyền truy cập để theo dõi chuyến đi | Ứng dụng dành cho người tiêu dùng lấy mã chuyến đi từ phần phụ trợ của bạn và yêu cầu bắt đầu theo dõi chuyến đi. |
| 4 | Tài xế bắt đầu chuyến đi | Khi tài xế sử dụng ứng dụng dành cho tài xế để cho biết chuyến đi đã bắt đầu, ứng dụng sẽ thông báo cho máy chủ phụ trợ của bạn thông qua Driver SDK. Ví dụ: khi tài xế sắp rời khỏi nhà hàng hoặc lái xe đến địa điểm lấy hàng. |
| 5 | Fleet Engine bắt đầu gửi thông tin về chuyến đi | Công cụ quản lý đội xe bắt đầu theo dõi chuyến đi và chia sẻ tiến trình với ứng dụng dành cho người tiêu dùng. |
| 6 | Ứng dụng dành cho người tiêu dùng hiển thị thông tin về chuyến đi | Ứng dụng dành cho người tiêu dùng sẽ thông báo cho người tiêu dùng và bắt đầu hiển thị thông tin chuyến đi cho họ, đồng thời cập nhật chuyến đi khi chuyến đi diễn ra. |
| 7 | Chuyến đi bị huỷ hoặc đã hoàn tất | Khi tài xế huỷ hoặc hoàn tất chuyến đi, ứng dụng của tài xế sẽ tắt tính năng theo dõi vị trí và máy chủ phụ trợ của bạn sẽ yêu cầu Fleet Engine đánh dấu chuyến đi là đã huỷ hoặc đã hoàn tất. |
| 8 | Ứng dụng của người tiêu dùng ngừng theo dõi chuyến đi | Chuyến đi được hiển thị là đã huỷ hoặc đã hoàn tất. |
| 9 | Quy trình này lặp lại cho chuyến đi tiếp theo | Một chuyến đi mới được tạo và quy trình này lặp lại. |
Cách sử dụng Consumer SDK
Chọn nền tảng của bạn để xem cách bắt đầu theo dõi chuyến đi trong ứng dụng dành cho người tiêu dùng.
Android
| 1 | Thiết lập Consumer SDK trong Android | Để theo dõi các chuyến đi theo yêu cầu trong ứng dụng, hãy thiết lập SDK Người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Tải SDK Người tiêu dùng Android. |
| 2 | Thiết lập giao diện trực quan | Xác định bản đồ và thêm chế độ hỗ trợ bản đồ vectơ để thiết lập trải nghiệm người dùng. Để biết thêm thông tin, hãy xem phần Thiết lập bản đồ. |
| 3 | Theo dõi chuyến đi | Theo dõi một chuyến đi để chia sẻ vị trí của xe phù hợp với người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Theo dõi hành trình. |
| 5 | Cập nhật tiến trình chuyến đi và xử lý lỗi chuyến đi | Cập nhật thông tin chi tiết về chuyến đi, chẳng hạn như quãng đường di chuyển và thời gian đến dự kiến, đồng thời xử lý mọi lỗi trong chuyến đi. Để biết thêm thông tin, hãy xem bài viết Cập nhật tiến trình chuyến đi và Xử lý lỗi chuyến đi. |
| 5 | Khi chuyến đi hoàn tất, hãy ngừng theo dõi | Dừng theo dõi chuyến đi để ngừng chia sẻ vị trí của xe với người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Ngừng theo dõi chuyến đi. |
iOS
| 1 | Thiết lập Consumer SDK trong iOS | Để theo dõi các chuyến đi theo yêu cầu trong ứng dụng, hãy thiết lập SDK Người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Tải SDK người tiêu dùng cho iOS. |
| 2 | Thiết lập giao diện hình ảnh | Khởi chạy chế độ xem bản đồ và xử lý các sự kiện trên bản đồ để thiết lập trải nghiệm cho người tiêu dùng. Để biết thêm thông tin, hãy xem phần Thiết lập bản đồ. |
| 3 | Theo dõi chuyến đi | Theo dõi một chuyến đi để chia sẻ vị trí của chiếc xe phù hợp cho người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Theo dõi hành trình. |
| 5 | Cập nhật tiến trình chuyến đi và xử lý lỗi chuyến đi | Cập nhật thông tin chi tiết về chuyến đi, chẳng hạn như quãng đường di chuyển và thời gian đến dự kiến, đồng thời xử lý mọi lỗi trong chuyến đi. Để biết thêm thông tin, hãy xem bài viết Cập nhật tiến trình chuyến đi và Xử lý lỗi chuyến đi. |
| 5 | Khi chuyến đi hoàn tất, hãy ngừng theo dõi | Ngừng theo dõi một chuyến đi để ngừng chia sẻ vị trí của xe với người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Ngừng theo dõi chuyến đi. |
JavaScript
| 1 | Thiết lập SDK Người tiêu dùng trong JavaScript | Để theo dõi các chuyến đi theo yêu cầu trong ứng dụng, hãy thiết lập Consumer SDK. Để biết thêm thông tin, hãy xem bài viết Thiết lập JavaScript Consumer SDK. |
| 2 | Tải và tuỳ chỉnh bản đồ | Bật Maps JavaScript API và thiết lập quy trình uỷ quyền để thiết lập trải nghiệm cho người tiêu dùng. Để biết thêm thông tin, hãy xem phần Thiết lập bản đồ. |
| 3 | Theo dõi chuyến đi | Theo dõi một chuyến đi để chia sẻ vị trí của xe phù hợp với người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Theo dõi hành trình. |
| 5 | Cập nhật tiến trình chuyến đi và xử lý lỗi chuyến đi | Cập nhật thông tin chi tiết về chuyến đi, chẳng hạn như quãng đường di chuyển và thời gian đến dự kiến, đồng thời xử lý mọi lỗi trong chuyến đi. Để biết thêm thông tin, hãy xem bài viết Cập nhật và theo dõi tiến trình chuyến đi và Xử lý lỗi chuyến đi. |
| 5 | Khi chuyến đi hoàn tất, hãy ngừng theo dõi | Ngừng theo dõi một chuyến đi để ngừng chia sẻ vị trí của xe với người tiêu dùng. Để biết thêm thông tin, hãy xem bài viết Ngừng theo dõi chuyến đi. |
Thành phần
Phần này tóm tắt hai thành phần cần thiết để theo dõi một chuyến đi:
Nếu muốn, bạn cũng có thể tuỳ chỉnh trải nghiệm của người tiêu dùng bằng các thành phần sau:
Trình tìm nạp mã thông báo xác thực
Để kiểm soát quyền truy cập vào dữ liệu vị trí được lưu trữ trong Fleet Engine, bạn phải làm như sau:
Triển khai dịch vụ tạo Mã thông báo web JSON (JWT) cho Fleet Engine trên máy chủ của bạn. Để biết thêm thông tin, hãy xem phần Phát hành JWT.
Triển khai trình tìm nạp mã thông báo xác thực trong ứng dụng web hoặc ứng dụng di động để xác thực quyền truy cập vào dữ liệu vị trí. Để biết thêm thông tin về cách thiết lập trình tìm nạp mã thông báo, hãy xem hướng dẫn thiết lập cho Android, iOS hoặc JavaScript.
Chế độ xem bản đồ và trình theo dõi chuyến đi
Tính năng theo dõi chuyến đi bao gồm các thành phần để trực quan hoá xe và điểm tham chiếu, cũng như nguồn cấp dữ liệu thô về thời gian đến dự kiến của tài xế hoặc quãng đường còn lại cần lái xe.
Bảng sau đây mô tả các thành phần này:
| Thành phần | Mô tả |
|---|---|
| Chế độ xem bản đồ của người tiêu dùng | Chế độ xem bản đồ quản lý vòng đời của một chuyến đi, cho thấy các điểm tham chiếu cho vị trí của xe khi chuyến đi diễn ra. Nếu biết tuyến đường của một xe, khung hiển thị bản đồ sẽ cập nhật đường nhiều đoạn của tuyến đường xe để cho biết tiến trình của xe dọc theo tuyến đường. |
| Trình cung cấp vị trí chuyến đi bằng JavaScript | Đối với ứng dụng web JavaScript, nhà cung cấp vị trí chuyến đi sẽ cung cấp thông tin vị trí cho các đối tượng được theo dõi vào bản đồ chuyến đi được chia sẻ. Để biết thêm thông tin, hãy xem phần Tạo thực thể cho trình cung cấp vị trí chuyến đi.
Bạn có thể dùng trình cung cấp vị trí của chuyến đi để theo dõi các thông tin chi tiết sau đây cho một chuyến đi:
|
Đối tượng vị trí được theo dõi
Nhà cung cấp vị trí theo dõi vị trí của các đối tượng như điểm tham chiếu và phương tiện, được mô tả trong bảng sau.
| Vị trí được theo dõi | Mô tả |
|---|---|
| Địa điểm nhận xe | Địa điểm đón khách là nơi bắt đầu chuyến đi. |
| Vị trí của điểm đến | Vị trí đích đến là vị trí kết thúc chuyến đi. Biểu tượng này đánh dấu địa điểm trả khách. |
| Vị trí điểm tham chiếu | Vị trí điểm tham chiếu là bất kỳ vị trí trung gian nào dọc theo tuyến đường của một chuyến đi được theo dõi. Mặc dù về mặt kỹ thuật, điểm tham chiếu có thể bao gồm cả địa điểm đón và trả khách, nhưng điểm tham chiếu thường là các điểm dừng trung gian dọc theo tuyến đường. Ví dụ: các điểm dừng giữa vị trí lấy hàng và vị trí giao hàng trên tuyến đường giao hàng là vị trí điểm tham chiếu. Để biết thêm thông tin, hãy xem phần Điểm tham chiếu của chuyến đi trong tài liệu Fleet Engine. |
| Vị trí xe | Vị trí của xe là vị trí được báo cáo của một chiếc xe. Để biết thêm thông tin, hãy xem phần Vị trí của xe trong tài liệu về Fleet Engine. |
Tạo kiểu cho bản đồ
Kiểu điểm đánh dấu và hình nhiều đường xác định giao diện của các đối tượng vị trí được theo dõi trên bản đồ. Bạn có thể sử dụng các lựa chọn tạo kiểu tuỳ chỉnh để phù hợp với kiểu của ứng dụng web.
Kiểm soát chế độ hiển thị của vị trí được theo dõi
Các nhà cung cấp vị trí được xác định trước trong Fleet Engine tuân theo các quy tắc hiển thị này cho các đối tượng vị trí được theo dõi trên bản đồ. Nếu tạo một trình cung cấp vị trí tuỳ chỉnh hoặc vị trí phái sinh, bạn có thể thay đổi các quy tắc hiển thị.
Xe chỉ xuất hiện khi chuyến đi đang diễn ra: Xe của chuyến đi sẽ xuất hiện từ thời điểm được chỉ định cho chuyến đi đến thời điểm trả khách. Nếu chuyến đi bị huỷ, xe sẽ không xuất hiện nữa.
Tất cả các điểm đánh dấu vị trí khác luôn hiển thị: Tất cả các điểm đánh dấu vị trí khác cho điểm bắt đầu, điểm đến và điểm dừng luôn xuất hiện trên bản đồ. Ví dụ: vị trí trả khách của chuyến đi hoặc vị trí giao hàng của lô hàng luôn xuất hiện trên bản đồ, bất kể trạng thái của chuyến đi hoặc lô hàng.
Bước tiếp theo
Xem tài liệu về nền tảng mà bạn muốn theo dõi chuyến đi: