Tài liệu trong phần này cho biết 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 của Google Maps Mobility. Bài viết này giả định bạn đã quen thuộc với những nội dung sau:
- Công cụ của Fleet: Bạn phải nắm rõ thông tin chi tiết về việc triển khai Công cụ của Fleet, cơ chế yêu cầu và 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 tệp tham chiếu trường 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 tương ứng với các điểm trung gian được xác định vị trí địa lý được chỉ định cho xe và Công cụ quản lý đội xe sẽ sửa đổi các điểm trung gian này của xe theo từng lần cập nhật chuyến đi mà bạn thực hiện. 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ả một ví dụ về quy trình toàn diện 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 Công cụ quản lý đội xe. Giả sử bạn đã thiết lập Công cụ quản lý đội xe và có một xe để chỉ định cho chuyến đi, với tính năng cập nhật vị trí được bật trong ứng dụng dành cho tài xế. Xem phần SDK dành cho tài xế: Chuyến đi theo yêu cầu.
| 1 | Nhận yêu cầu đặt phòng. | Trước khi một chuyến đi bằng Công cụ dành cho đội xe bắt đầu, trước tiên, hệ thống đặt chỗ của bạn sẽ nhận được yêu cầu đi xe hoặc giao hàng của người tiêu dùng thông qua ứng dụng của bạn hoặc hệ thống đặt chỗ 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.
Tại thời điểm này, lớp này cũng có thể thiết lập các trường khác, chẳng hạn như số hành khách và vị trí trả khách, hoặc chờ cho đến khi chỉ định một 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 đều 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. | Động cơ xe cung cấp thông tin chi tiết về chuyến đi và vị trí xe cho SDK người dùng. 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ị thông tin đó trong ứng dụng dành cho người dùng. Động cơ xe tự động cập nhật thời gian đến dự kiến, quãng đường còn lại, tuyến đường và các điểm trung gian còn lại của xe. Hãy xem phần 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 trung gian đích 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 Công cụ quản lý đội xe. 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á. |
Quy trình trình tự chuyến đi
Sơ đồ sau đây cho thấy thông tin chi tiết hơn về quy trình này.
