Tổng quan về các chuyến đi theo yêu cầu qua SDK của người tiêu dùng

Đ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ọ.

Ứng dụng dành cho người tiêu dùng theo dõi chuyến đi

Consumer SDK là gì?

Consumer SDK 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 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 dựa trên bản đồ phong phú 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 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 Consumer SDK 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 tin 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. 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 vị trí của chuyến xe hoặc đơn hàng.

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á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ỳ.

  • Cho biết thời gian đến dự kiến (ETA) cho địa điểm đến lấy hàng và địa điểm trả hàng.

  • Hiện khoảng cách 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 Consumer SDK

Nhìn chung, Consumer SDK 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 TripModelJourneySharingSession mô hình hoá dữ liệu chuyến đi và chia sẻ các phiên chuyến đi trong ứng dụng 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ú, đầy đủ thông tin chi tiết như lưu lượng truy cập, điểm đánh dấu trên bản đồ, thời gian đến dự kiến và dữ liệu về tuyến đường.

cách Consumer SDK hoạt độ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 tuân theo.

1 Ứng dụng dành cho người tiêu dùng yêu cầu 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:
  • Tạo một chuyến đi trong Fleet Engine.
  • Chỉ định chuyến đi cho một xe.
2 Tài xế chấp nhận chuyến đi Ứng dụng dành cho 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 dành cho người tiêu dùng nhận 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 nhận hàng.
5 Fleet Engine bắt đầu gửi thông tin về chuyến đi Fleet Engine bắt đầu theo dõi chuyến đi và chia sẻ tiến trình với ứng dụng 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 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 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 đượ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 bạn sử dụng để 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 SDK người 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ợ 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 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 phần 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ề 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 phần Cập nhật tiến trình chuyến điXử lý lỗi chuyến đi.
5 Khi chuyến đi hoàn tất, hãy dừ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 phần 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 Consumer SDK. Để biết thêm thông tin, hãy xem phần Tải SDK người tiêu dùng 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 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 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 phần 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ề 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 phần Cập nhật tiến trình chuyến điXử lý lỗi chuyến đi.
5 Khi chuyến đi hoàn tất, hãy dừ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 phần Ngừng theo dõi chuyến đi.

JavaScript

1 Thiết lập Consumer SDK bằng 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ền uỷ 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 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 phần 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ề 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 của chuyến điXử lý lỗi trong chuyến đi.
5 Khi chuyến đi hoàn tất, hãy dừ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 phần Ngừng theo dõi 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:

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 (không bắt buộc):

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:

  1. 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.

  2. Triển khai một trình tìm nạp mã thông báo xác thực trong các ứng dụng web hoặc 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 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ô cho thời gian đến dự kiến của người lái xe hoặc khoảng cách còn lại cần lái.

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, 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 phương tiện, khung hiển thị bản đồ sẽ cập nhật đường đa tuyến của tuyến đường phương tiện để cho biết tiến trình của phương tiện dọc theo tuyến đường.
Trình cung cấp vị trí chuyến đi bằng 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 dùng chung. Để 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í của 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:
  • Vị trí đón hoặc trả khách của một chuyến đi.
  • Vị trí và tuyến đường của xe được chỉ định 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à xe, đượ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í của điểm đến Vị trí đến là vị trí kết thúc chuyến đi. Nó đánh dấu vị trí trả xe.
Vị trí điểm tham chiếu Vị trí điểm tham chiếu là vị trí trung gian bất kỳ 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 vị trí đón và trả khách, nhưng điểm tham chiếu thường đề cập đến các điểm dừng chân 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í đích 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 trên hành trình trong tài liệu Fleet Engine.
Vị trí của 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 Fleet Engine.

Tạo kiểu cho bản đồ

Kiểu điểm đánh dấu và kiểu đường nhiều đoạ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 lựa chọn tạo kiểu tuỳ chỉnh để điều chỉnh cho 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 đối với 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ị.

  • Phương tiện chỉ xuất hiện khi chuyến đi đang diễn ra: Phương tiện của chuyến đi sẽ xuất hiện từ thời điểm được chỉ định cho chuyến đi cho đến thời điểm trả khách. Nếu chuyến đi bị huỷ, phương tiện 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 việc giao hàng.

Bước tiếp theo

Hãy xem tài liệu về nền tảng mà bạn muốn theo dõi các chuyến đi: