Chuyến đi theo yêu cầu là gì?

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:

TripService mà bạn sẽ dùng có sẵn cho gRPCREST. Để đơ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 một chiếc 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 SearchVehicle trả về phương tiện mà bạn khớp trong một chuyến đi, hệ thống gọi điểm cuối UpdateTrip để báo cáo mã xe mà bạn đã chỉ định cho chuyến đi NEW.

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. Tại thời điểm đó, các cookie 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.

TripSequenceDiagram

Các bước tiếp theo