Tài liệu trong phần này trình bày cách tạo và làm việc với các chuyến đi bằng dịch vụ chuyến đi theo yêu cầu của Google Maps Mobility. Tài liệu này giả định rằng bạn đã quen thuộc với những nội dung sau:
- Fleet Engine: Bạn nên làm quen với thông tin chi tiết về cách triển khai Fleet Engine , cơ chế yêu cầu và bảo mật. Để biết thông tin đó, hãy xem bài viết Dịch vụ Fleet Engine là gì? và các chủ đề về bảo mật trong bài viết Thiết lập Fleet Engine.
- Thông tin 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 cho các dịch vụ theo yêu cầu. Xem bài viết 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 tham chiếu trường tuân theo quy ước gRPC.
Trong Fleet Engine 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 yêu cầu đi xe của người tiêu dùng. Chuyến đi có một trạng thái mà bạn báo cáo cho Fleet Engine khi hành trình diễn ra, chẳng hạn như NEW, ENROUTE_TO_PICKUP và nhiều trạng thái khác. Trạng thái chuyến đi tương ứng với các điểm tham chiếu được định vị theo vị trí địa lý được chỉ định cho xe và Fleet Engine sẽ sửa đổi các điểm tham chiếu của xe này theo mỗi thông tin cập nhật về chuyến đi mà bạn thực hiện. Hãy xem bài viết Chuyến đi theo yêu cầu trong phần Thông tin cơ bản về Fleet Engine để biết thêm về các chuyến đi và mối quan hệ của chúng với xe.
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 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 đầu cuối của một chuyến đi được tạo trong hệ thống của bạn và các giai đoạn 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 đã bật tính năng cập nhật vị trí trong ứng dụng dành cho tài xế. Hãy xem bài viết Driver SDK: Chuyến đi theo yêu cầu.
| 1 | Nhận yêu cầu đặt chỗ. | Trước khi một chuyến đi trong Fleet Engine bắt đầu, hệ thống đặt chỗ của bạn sẽ nhận được một yêu cầu đi xe hoặc giao hàng từ người tiêu dùng thông qua ứng dụng hoặc hệ thống đặt chỗ khác. Sau đó, hệ thống của bạn sẽ tạo thực thể chuyến đi bằng
CreateTrip với các trường bắt buộc, chẳng hạn như vị trí đón.
Hệ thống cũng có thể đặt các trường khác tại thời điểm này, chẳng hạn như hành khách và
vị trí trả khách, hoặc đợi cho đến khi chỉ định một chiếc xe. Xem
Bài viết tạo chuyến đi có một điểm đến. |
| 2 | Chỉ định xe. | Bạn có thể chỉ định xe cho các chuyến đi trực tiếp 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ể 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à thuộc tính xe để tìm chiếc xe phù hợp nhất để hoàn thành hành trình. Bất kỳ chiếc xe trực tuyến nào trong phạm vi tìm kiếm của bạn đều cho biết khoảng cách gần của chúng thông qua thông tin cập nhật vị trí do Driver SDK 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í 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. Fleet Engine nhận được luồng thông tin cập nhật vị trí xe liên tục từ Driver SDK. Sau đó, hệ thống của bạn sẽ báo cáo từng cột mốc hành trình cho Fleet Engine. Fleet Engine 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í xe cho Consumer SDK. SDK này sử dụng một 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 (ETA), khoảng cách 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 đích của chuyến đi và tài xế cho biết chuyến đi đã hoàn tất, hệ thống của bạn 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 Fleet Engine 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 chế độ xem chi tiết hơn về quy trình này.
