Chuyến đi theo yêu cầu là gì?
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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:
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 này của xe 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 thông tin 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 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 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 người lái xe. 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 trên Fleet Engine bắt đầu, hệ thống đặt phòng 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 phòng 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 SearchVehicle trả về một chiếc xe phù hợp với chuyến đi, hệ thống của bạn sẽ gọi điểm cuối UpdateTrip để báo cáo mã nhận dạng xe mà bạn đã chỉ định cho chuyến đi NEW.
|
| 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à người lái xe 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.
Bước tiếp theo
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThis documentation provides a comprehensive guide on utilizing the Google Maps Mobility on-demand trips service for managing and tracking trips.\u003c/p\u003e\n"],["\u003cp\u003eYou should have a foundational understanding of Fleet Engine, Vehicle Basics, and Trip Basics for on-demand services.\u003c/p\u003e\n"],["\u003cp\u003eFleet Engine's \u003ccode\u003eTripService\u003c/code\u003e enables the creation, assignment, updating, and completion of trips through gRPC or REST.\u003c/p\u003e\n"],["\u003cp\u003eTrips represent journeys fulfilling consumer requests, evolving through various statuses like \u003ccode\u003eNEW\u003c/code\u003e, \u003ccode\u003eENROUTE_TO_PICKUP\u003c/code\u003e, and \u003ccode\u003eCOMPLETE\u003c/code\u003e, influencing vehicle waypoints.\u003c/p\u003e\n"],["\u003cp\u003eThe trip lifecycle includes booking, vehicle assignment, status updates, consumer journey sharing, and completion, all managed through Fleet Engine interactions.\u003c/p\u003e\n"]]],[],null,["The documentation in this section shows how to create and work with trips using\nthe Google Maps Mobility on-demand trips service. It assumes familiarity with\nthe following:\n\n- **Fleet Engine** : You should be familiar with Fleet Engine implementation details, request mechanisms, and security. For that, see [What is the Fleet\n Engine service?](/maps/documentation/mobility/fleet-engine/essentials) and the security topics in [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n- **Vehicles basics** for on-demand services. See [Introduction to vehicles](/maps/documentation/mobility/fleet-engine/essentials/vehicles-intro).\n- **Trip basics** for on-demand services. See [On-demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro).\n\nThe `TripService` that you'll use is available for [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#tripservice) and [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips).\nFor simplicity sake, field references follow the gRPC convention.\n\nIn Fleet Engine for on-demand services, a trip is a type of journey that models\nthe fulfillment of a food delivery or ride request from your consumers. A trip\nhas a status that you report to Fleet Engine as the journey evolves, such as\n`NEW`, `ENROUTE_TO_PICKUP`, and more. The trip status corresponds to geo-located\nwaypoints assigned to the vehicle, and Fleet Engine modifies these vehicle\nwaypoints with each trip update you make. See [On demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro) in **Fleet\nEngine essentials** for more about trips and their relationship to vehicles.\n\nLife of a trip\n\nIn order to track each trip in Fleet Engine, you must first create a `Trip`\nentity. See either [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#maps.fleetengine.v1.Trip) or [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips) for reference.\n\nThe following table describes an example end-to-end flow of a trip created in\nyour system and its lifecycle stages in Fleet Engine. It assumes you have set up\nFleet Engine and have a vehicle to assign to the trip, with location updates\nenabled in the driver app. See [Driver SDK: On-demand trips](/maps/documentation/mobility/driver-sdk/on-demand).\n\n|---|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Receive booking request.** | Before a Fleet Engine trip begins, your booking system first receives a request for a ride or delivery from a consumer through your app or other booking system. Your system then creates the trip entity using `CreateTrip` with required fields, such as the pickup location. It can also set other fields at this point, such passengers and dropoff location, or wait until it assigns a vehicle. See [Create a single-destination trip](/maps/documentation/mobility/fleet-engine/journeys/trips/create-trip). |\n| 2 | **Assign vehicle.** | You can either assign vehicles to trips directly within your system and report the assignment to Fleet Engine, or you can use the [Search Vehicle](/maps/documentation/mobility/fleet-engine/essentials/vehicles/on-demand-search-vehicle) service to search for vehicles, filtering by both trip and vehicle attributes to find the best vehicle to complete the journey. Any online vehicle within your search radius makes their proximity known through location updates provided by the Driver SDK. Once `SearchVehicle` returns a vehicle that you match to a trip, your system calls the `UpdateTrip` endpoint to report the vehicle ID you assigned to the `NEW` trip. |\n| 3 | **Update trip.** | Once the driver accepts the trip and begins navigating to the pickup location, your system updates the trip status from `NEW` to `ENROUTE_TO_PICKUP`. You continue to poll the vehicle location throughout the journey, either through a direct connection from the app to your backend, or by polling Fleet Engine, which receives an ongoing stream of vehicle location updates from the Driver SDK. Your system then reports each journey milestone to Fleet Engine, which updates the vehicle's waypoint list accordingly. |\n| 4 | **Share journey with consumer.** | Fleet Engine makes trip details and vehicle location available to the Consumer SDK, which uses a listener to receive trip updates and display them in the consumer app. Fleet Engine automatically updates ETA, remaining distance, routes, and remaining vehicle waypoints. See [Share journeys for on-demand trips](/maps/documentation/mobility/journey-sharing/on-demand) for more information. |\n| 5 | **Complete trip.** | Once the vehicle reaches the destination waypoint of the trip and your driver indicates a successful trip, your system sets the `TripStatus` to `COMPLETE` in Fleet Engine. Keep in mind that, like vehicles, trip entities remain active within Fleet Engine for 7 days regardless of status, at which point they are removed. |\n\nTrip sequence flow\n\nThe following diagram shows a more detailed view of this flow.\n\nWhat's next\n\n- [Create a single-destination trip](/maps/documentation/mobility/fleet-engine/journeys/trips/create-trip)"]]
