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