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