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 của Google Maps Mobility. Giả định rằng bạn đã quen thuộc với như sau:
- Fleet Engine: Bạn nên quen thuộc với việc triển khai Fleet Engine thông tin chi tiết, cơ chế yêu cầu và bảo mật. Để biết câu trả lời đó, hãy xem bài viết Hệ thống là gì Dịch vụ công cụ? và các chủ đề bảo mật trong bài viết Thiết lập Fleet Engine.
- Thông tin cơ bản về xe cho dịch vụ theo yêu cầu. Xem Giới thiệu về phương tiện di chuyển.
- Thông tin cơ bản về chuyến đi cho 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ẽ 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 Fleet Engine, đối với các dịch vụ theo yêu cầu, chuyến đi là một loại hành trình mà mô hình
việc người tiêu dùng thực hiện yêu cầu giao đồ ăn hoặc gọi xe. Một chuyến đi
có trạng thái mà bạn báo cáo cho Fleet Engine khi hành trình thay đổi, chẳng hạn như
NEW, ENROUTE_TO_PICKUP và các lý do khác. Trạng thái chuyến đi tương ứng với vị trí địa lý
điểm tham chiếu được chỉ định cho xe và Fleet Engine sửa đổi những chiếc xe này
điểm tham chiếu của mỗi thông tin cập nhật về chuyến đi do bạn thực hiện. Xem Chuyến đi theo yêu cầu trong Đội phương tiện vận chuyển
Kiến thức cơ bản về công cụ để tìm hiểu thêm về các chuyến đi và mối quan hệ giữa các chuyến đi và phương tiện di chuyển.
Vòng đời của một chuyến đi
Để theo dõi từng chuyến đi trong Fleet Engine, trước tiên bạn phải tạo một Trip
thực thể. 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 hệ thống trong Fleet Engine. Giả sử bạn đã thiết lập Fleet Engine và một chiếc xe để chỉ định cho chuyến đi, kèm theo thông tin cập nhật về vị trí bật trong ứng dụng trình điều khiển. Hãy xem SDK dành cho tài xế: Chuyến đi theo yêu cầu.
| 1 | Nhận yêu cầu đặt trước. | Trước khi bắt đầu một chuyến đi trên Fleet Engine, trước tiên, hệ thống đặt vé của bạn sẽ nhận được
yêu cầu người tiêu dùng gọi xe hoặc giao hàng thông qua ứng dụng của bạn hoặc
hệ thống đặt phòng. Sau đó, hệ thống của bạn tạo mục chuyến đi bằng cách sử dụng
CreateTrip có các trường bắt buộc, chẳng hạn như vị trí đến lấy hàng.
Máy chủ cũng có thể đặt các trường khác tại thời điểm này, như hành khách và
điểm trả xe hoặc đợi cho đến khi hệ thống chỉ định xe. Xem
Tạo chuyến đi một điểm đến. |
| 2 | Chỉ định xe. | Bạn có thể chỉ định xe cho các chuyến đi ngay trong hệ thống của mình và báo cáo việc chỉ định đó cho Fleet Engine, hoặc bạn có thể dùng Tìm xe dịch vụ tìm kiếm xe, lọc theo cả chuyến đi và xe để tìm chiếc xe tốt nhất để hoàn thành hành trình. Bất kỳ phương thức thanh toán nào đang trực tuyến xe trong phạm vi bán kính tìm kiếm của bạn sẽ giúp người dùng biết được khoảng cách đó qua thông tin cập nhật về 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 người lái xe chấp nhận chuyến đi và bắt đầu đi đến
vị trí đón, hệ thống sẽ cập nhật trạng thái chuyến đi từ NEW
đến ENROUTE_TO_PICKUP. Bạn sẽ tiếp tục thăm dò ý kiến của xe
vị trí trong suốt hành trình, thông qua kết nối trực tiếp từ
ứng dụng vào phần phụ trợ của bạn hoặc bằng cách thăm dò Fleet Engine, công cụ này nhận được
luồng cập nhật liên tục về vị trí của xe từ SDK tài xế. Thông tin
sau đó, hệ thống báo cáo từng mốc quan trọng của hành trình cho Fleet Engine, vốn sẽ cập nhật
danh sách điểm tham chiếu 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 thông tin chi tiết về chuyến đi và vị trí của xe cho SDK người tiêu dùng 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 tiêu dùng. Fleet Engine tự động cập nhật thời gian đến dự kiến (còn lại) quãng đường, tuyến đường và điểm tham chiếu còn lại của xe. Xem 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 thành chuyến đi. | Khi xe đến điểm tham chiếu của chuyến đi và
người lái xe cho biết chuyến đi thành công, hệ thống của bạn sẽ thiết lập
TripStatus đến COMPLETE trong Fleet Engine. Giữ lại
hãy lưu ý rằng, chẳng hạn như phương tiện vận chuyển, tổ chức chuyến đi vẫn hoạt động trong Fleet Engine
trong 7 ngày bất kể trạng thái. Sau thời điểm đó, các URL 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.
