Tài liệu trong phần này trình bày cách tạo và xử lý các chuyến đi bằng dịch vụ chuyến đi theo yêu cầu trên Google Maps Mobility. Bài viết này giả định bạn đã quen thuộc với những nội dung sau:
- Fleet Engine: Bạn nên nắm rõ các chi tiết triển khai Fleet Engine, cơ chế yêu cầu và tính bảo mật. Để biết thông tin này, hãy xem bài viết Dịch vụ Công cụ của đội xe là gì? và các chủ đề về bảo mật trong bài viết Thiết lập Công cụ của đội xe.
- Kiến thức cơ bản về xe cho các dịch vụ theo yêu cầu. Xem bài viết Giới thiệu về xe.
- Thông tin cơ bản về chuyến đi đối với các dịch vụ theo yêu cầu. Xem phần Chuyến đi theo yêu cầu.
TripService mà bạn sẽ sử dụng có sẵn cho gRPC và REST.
Để đơn giản, các nội dung tham chiếu trường sẽ tuân theo quy ước gRPC.
Trong Công cụ xe cho các dịch vụ theo yêu cầu, chuyến đi là một loại hành trình mô hình hoá việc thực hiện yêu cầu giao đồ ăn hoặc đi xe của người tiêu dùng. Mỗi chuyến đi có một trạng thái mà bạn báo cáo cho Công cụ quản lý đội xe khi hành trình diễn ra, chẳng hạn như NEW, ENROUTE_TO_PICKUP, v.v. Trạng thái chuyến đi sẽ tương ứng với các điểm tham chiếu được xác định vị trí địa lý được chỉ định cho xe và Fleet Engine sẽ sửa đổi các điểm tham chiếu xe này với mỗi lần bạn cập nhật chuyến đi. Xem phần Chuyến đi theo yêu cầu trong bài viết Kiến thức cơ bản về Công cụ quản lý đội xe để biết thêm về các chuyến đi và mối quan hệ của các chuyến đi đó với xe.
Vòng đời của một chuyến đi
Để theo dõi từng chuyến đi trong Công cụ quản lý đội xe, trước tiên, bạn phải tạo một thực thể Trip. Hãy xem gRPC hoặc REST để tham khảo.
Bảng sau đây mô tả ví dụ về quy trình hai đầu của một chuyến đi được tạo trong hệ thống của bạn và các giai đoạn trong vòng đời của chuyến đi đó trong Fleet Engine. Giả sử bạn đã thiết lập Fleet Engine và có một chiếc xe để chỉ định cho chuyến đi, đồng thời thông tin cập nhật vị trí sẽ được bật trong ứng dụng dành cho người lái xe. Hãy xem phần Driver SDK: Chuyến đi theo yêu cầu.
| 1 | Nhận yêu cầu đặt trước. | Trước khi một chuyến đi trên Fleet Engine bắt đầu, trước tiên, hệ thống đặt vé của bạn sẽ nhận được yêu cầu gọi xe hoặc giao hàng từ người tiêu dùng thông qua ứng dụng của bạn hoặc một hệ thống đặt vé khác. Sau đó, hệ thống sẽ tạo thực thể chuyến đi bằng cách sử dụng CreateTrip với các trường bắt buộc, chẳng hạn như vị trí đón.
Ứng dụng cũng có thể thiết lập các trường khác vào thời điểm này, chẳng hạn như hành khách và vị trí trả xe hoặc chờ cho đến khi chỉ định một chiếc xe. Xem phần Tạo chuyến đi có một điểm đến. |
| 2 | Chỉ định xe. | Bạn có thể chỉ định xe cho chuyến đi ngay trong hệ thống của mình và báo cáo việc chỉ định cho Công cụ quản lý đội xe, hoặc bạn có thể sử dụng dịch vụ Tìm kiếm xe để tìm kiếm xe, lọc theo cả thuộc tính chuyến đi và xe để tìm xe phù hợp nhất để hoàn thành hành trình. Mọi xe trực tuyến trong bán kính tìm kiếm của bạn sẽ cho biết khoảng cách của chúng thông qua thông tin cập nhật vị trí do SDK Trình điều khiển cung cấp. Sau khi |
| 3 | Cập nhật chuyến đi. | Sau khi tài xế chấp nhận chuyến đi và bắt đầu di chuyển đến vị trí đón, hệ thống của bạn sẽ cập nhật trạng thái chuyến đi từ NEW thành ENROUTE_TO_PICKUP. Bạn tiếp tục thăm dò vị trí của xe trong suốt hành trình, thông qua kết nối trực tiếp từ ứng dụng đến phần phụ trợ hoặc bằng cách thăm dò Fleet Engine. Công cụ này sẽ nhận được luồng cập nhật liên tục về vị trí của xe từ SDK Trình điều khiển. Sau đó, hệ thống của bạn sẽ báo cáo từng mốc quan trọng của hành trình cho Công cụ quản lý đội xe. Công cụ này sẽ cập nhật danh sách điểm trung gian của xe cho phù hợp.
|
| 4 | Chia sẻ hành trình với người tiêu dùng. | Fleet Engine cung cấp cho SDK người tiêu dùng thông tin chi tiết về chuyến đi và vị trí của xe. SDK này sử dụng trình nghe để nhận thông tin cập nhật về chuyến đi và hiển thị những thông tin này trong ứng dụng dành cho người dùng. Fleet Engine tự động cập nhật giờ đến dự kiến, quãng đường còn lại, tuyến đường và các điểm tham chiếu còn lại của xe. Hãy xem bài viết Chia sẻ hành trình cho các chuyến đi theo yêu cầu để biết thêm thông tin. |
| 5 | Hoàn tất chuyến đi. | Sau khi xe đến điểm tham chiếu của chuyến đi và tài xế cho biết chuyến đi đã thành công, hệ thống sẽ đặt TripStatus thành COMPLETE trong Fleet Engine. Xin lưu ý rằng, giống như xe, các thực thể chuyến đi vẫn hoạt động trong Công cụ quản lý đội xe trong 7 ngày bất kể trạng thái, sau đó các thực thể này sẽ bị xoá. |
Luồng trình tự chuyến đi
Biểu đồ dưới đây cho thấy chế độ xem chi tiết hơn về quy trình này.
