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