Tài liệu trong phần này cho biết cách tạo và sử dụng các chuyến đi bằng dịch vụ chuyến đi theo yêu cầu của Google Maps Mobility. Bạn cần phải nắm rõ những điều sau:
- Fleet Engine: Bạn nên nắm rõ thông tin chi tiết về việc triển khai Fleet Engine, cơ chế yêu cầu và bảo mật. Để biết thông tin về vấn đề này, hãy xem phần Dịch vụ Fleet Engine là gì? và các chủ đề về bảo mật trong phần Thiết lập Fleet Engine.
- Kiến thức cơ bản về xe cho các dịch vụ theo yêu cầu. Xem phần 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 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 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ó 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.v. Trạng thái chuyến đi tương ứng với các điểm tham chiếu được định vị đị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 mỗi khi bạn cập nhật chuyến đi. Xem phần Chuyến đi theo yêu cầu trong Các yếu tố cần thiết của Fleet Engine để biết thêm về chuyến đi và mối quan hệ giữa 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 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 từ đầu đến 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 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 đã 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 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 bắt đầu, hệ thống đặt chỗ của bạn sẽ nhận được yêu cầu đ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 hệ thống đặt chỗ khác. Sau đó, hệ thống 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.
Ứng dụ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 ứng dụng chỉ định một chiếc xe. Xem phần Tạo chuyến đi có một điểm đến. |
| 2 | Giao 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ể 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 được chiếc xe phù hợp nhất để hoàn thành hành trình. Mọi phương tiện 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 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 chỉ đường đế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ợ của bạn 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 liên tục về vị trí của xe từ Driver SDK. Sau đó, hệ thống của bạn sẽ báo cáo từng mốc quan trọng trong 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í của 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 dự kiến đến, 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 chuyến đi theo yêu cầu để biết thêm thông tin. |
| 5 | Hoàn tất chuyến đi. | 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 nào, sau đó chúng sẽ bị xoá. |
Luồng 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.
