Apa itu perjalanan on-demand?
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dokumentasi di bagian ini menunjukkan cara membuat dan menggunakan perjalanan menggunakan
layanan perjalanan on-demand Google Maps Mobility. Anda dianggap sudah memahami hal-hal berikut:
TripService yang akan Anda gunakan tersedia untuk gRPC dan REST.
Demi kesederhanaan, referensi kolom mengikuti konvensi gRPC.
Di Fleet Engine untuk layanan on-demand, perjalanan adalah jenis perjalanan yang memodelkan pemenuhan permintaan pengantaran makanan atau perjalanan dari konsumen Anda. Perjalanan
memiliki status yang Anda laporkan ke Fleet Engine saat perjalanan berlangsung, seperti
NEW, ENROUTE_TO_PICKUP, dan lainnya. Status perjalanan sesuai dengan titik jalan yang berlokasi geografis yang ditetapkan ke kendaraan, dan Fleet Engine mengubah titik jalan kendaraan ini dengan setiap update perjalanan yang Anda lakukan. Lihat Perjalanan on demand di Dasar-dasar Fleet Engine untuk mengetahui lebih lanjut perjalanan dan hubungannya dengan kendaraan.
Masa aktif perjalanan
Untuk melacak setiap perjalanan di Fleet Engine, Anda harus membuat entitas Trip
terlebih dahulu. Lihat gRPC atau REST untuk referensi.
Tabel berikut menjelaskan contoh alur end-to-end perjalanan yang dibuat di sistem Anda dan tahap siklus prosesnya di Fleet Engine. Panduan ini mengasumsikan Anda telah menyiapkan
Fleet Engine dan memiliki kendaraan untuk ditetapkan ke perjalanan, dengan pembaruan lokasi
diaktifkan di aplikasi pengemudi. Lihat Driver SDK: Perjalanan on-demand.
| 1 |
Menerima permintaan pemesanan. |
Sebelum perjalanan Fleet Engine dimulai, sistem pemesanan Anda terlebih dahulu menerima
permintaan perjalanan atau pengiriman dari konsumen melalui aplikasi Anda atau
sistem pemesanan lainnya. Sistem Anda kemudian membuat entitas perjalanan menggunakan
CreateTrip dengan kolom yang diperlukan, seperti lokasi penjemputan.
Aplikasi juga dapat menyetel kolom lain pada saat ini, seperti penumpang dan
lokasi pengantaran, atau menunggu hingga aplikasi menetapkan kendaraan. Lihat
Membuat perjalanan dengan satu tujuan. |
| 2 |
Menetapkan kendaraan. |
Anda dapat menetapkan kendaraan ke perjalanan secara langsung dalam sistem
dan melaporkan penetapan tersebut ke Fleet Engine, atau Anda dapat menggunakan
layanan Search Vehicle
untuk menelusuri kendaraan, memfilter berdasarkan perjalanan dan atribut
kendaraan untuk menemukan kendaraan terbaik guna menyelesaikan perjalanan. Kendaraan online
dalam radius penelusuran Anda akan memberitahukan kedekatannya melalui
pembaruan lokasi yang disediakan oleh Driver SDK.
Setelah SearchVehicle menampilkan kendaraan yang cocok dengan perjalanan Anda, sistem
akan memanggil endpoint UpdateTrip untuk melaporkan ID kendaraan
yang Anda tetapkan ke perjalanan NEW.
|
| 3 |
Perbarui perjalanan. |
Setelah pengemudi menerima perjalanan dan mulai bernavigasi ke
lokasi penjemputan, sistem Anda akan memperbarui status perjalanan dari NEW
menjadi ENROUTE_TO_PICKUP. Anda terus melakukan polling lokasi kendaraan
selama perjalanan, baik melalui koneksi langsung dari
aplikasi ke backend Anda, atau dengan melakukan polling Fleet Engine, yang menerima
aliran berkelanjutan pembaruan lokasi kendaraan dari Driver SDK. Sistem
Anda kemudian melaporkan setiap pencapaian perjalanan ke Fleet Engine, yang memperbarui
daftar titik jalan kendaraan.
|
| 4 |
Bagikan perjalanan dengan konsumen. |
Fleet Engine menyediakan detail perjalanan dan lokasi kendaraan untuk
Consumer SDK, yang menggunakan pemroses untuk menerima update perjalanan dan menampilkannya
di aplikasi konsumen. Fleet Engine otomatis memperbarui perkiraan waktu tiba, jarak
yang tersisa, rute, dan titik jalan kendaraan yang tersisa. Lihat
Membagikan perjalanan untuk perjalanan on-demand untuk mengetahui informasi selengkapnya. |
| 5 |
Selesaikan perjalanan. |
Setelah kendaraan mencapai titik jalan tujuan perjalanan dan pengemudi Anda menunjukkan perjalanan berhasil, sistem Anda akan menyetel TripStatus ke COMPLETE di Fleet Engine. Perlu diingat bahwa, seperti kendaraan, entitas perjalanan tetap aktif dalam Fleet Engine selama 7 hari terlepas dari statusnya, dan setelah itu akan dihapus. |
Alur urutan perjalanan
Diagram berikut menunjukkan tampilan alur ini yang lebih mendetail.
Langkah berikutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 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)"]]
