İsteğe bağlı seyahat nedir?
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu bölümdeki belgelerde, Google Haritalar Mobility on-demand geziler hizmetini kullanarak gezileri nasıl oluşturacağınız ve gezilerle nasıl çalışacağınız gösterilmektedir. Aşağıdaki konular hakkında bilgi sahibi olduğunuz varsayılır:
- Fleet Engine: Fleet Engine'in uygulanmasıyla ilgili ayrıntılar, istek mekanizmaları ve güvenlik hakkında bilgi sahibi olmanız gerekir. Bu konuda bilgi edinmek için Fleet Engine hizmeti nedir? ve Fleet Engine'i ayarlama bölümündeki güvenlik konularına bakın.
- İsteğe bağlı hizmetler için araçlarla ilgili temel bilgiler. Araçlara giriş başlıklı makaleyi inceleyin.
- İsteğe bağlı hizmetler için seyahatle ilgili temel bilgiler. Talep üzerine yolculuklar bölümüne bakın.
Kullanacağınız TripService, gRPC ve REST için kullanılabilir.
Kolaylık sağlamak için alan referansları gRPC kuralına uygundur.
Talep üzerine hizmetler için Fleet Engine'de yolculuk, tüketicilerinizden gelen yemek teslimatı veya yolculuk isteğinin karşılanmasını modelleyen bir tür seyahattir. Bir yolculuğun, yolculuk ilerledikçe Fleet Engine'e bildirdiğiniz bir durumu vardır. Örneğin, NEW, ENROUTE_TO_PICKUP ve daha fazlası. Seyahat durumu, araca atanan coğrafi konumlu ara noktalara karşılık gelir ve Fleet Engine, yaptığınız her seyahat güncellemesiyle bu araç ara noktalarını değiştirir. Geziler ve araçlarla ilişkileri hakkında daha fazla bilgi için Fleet Engine Essentials'daki İsteğe bağlı geziler bölümüne bakın.
Seyahatin ömrü
Fleet Engine'deki her yolculuğu izlemek için öncelikle bir Trip
entity oluşturmanız gerekir. Referans için gRPC veya REST'e bakın.
Aşağıdaki tabloda, sisteminizde oluşturulan bir seyahatin uçtan uca akışına ve Fleet Engine'deki yaşam döngüsü aşamalarına dair bir örnek açıklanmaktadır. Bu örnekte, Fleet Engine'i ayarladığınız ve sürücü uygulamasında konum güncellemeleri etkinleştirilmiş olarak geziye atayabileceğiniz bir aracınız olduğu varsayılır. Driver SDK: On-demand trips (Sürücü SDK'sı: Talep üzerine geziler) başlıklı makaleyi inceleyin.
| 1 |
Rezervasyon isteği alma |
Bir Fleet Engine yolculuğu başlamadan önce, rezervasyon sisteminiz ilk olarak uygulamanız veya başka bir rezervasyon sistemi aracılığıyla bir tüketiciden yolculuk ya da teslimat isteği alır. Sisteminiz daha sonra CreateTrip kullanarak, yolculuk öğesini oluşturur. Bu öğe, teslim alma konumu gibi gerekli alanları içerir.
Bu noktada yolcular ve bırakma konumu gibi diğer alanları da ayarlayabilir veya bir araç atanana kadar bekleyebilir. Tek varış noktalı gezi oluşturma başlıklı makaleyi inceleyin. |
| 2 |
Aracı atayın. |
Araçları doğrudan sisteminizde gezilere atayabilir ve atamayı Fleet Engine'e bildirebilirsiniz. Alternatif olarak, Search Vehicle hizmetini kullanarak araç arayabilir, yolculuğu tamamlamak için en uygun aracı bulmak üzere hem gezi hem de araç özelliklerine göre filtreleyebilirsiniz. Arama yarıçapınızdaki tüm online araçlar, sürücü SDK'sı tarafından sağlanan konum güncellemeleri aracılığıyla yakınlıklarını bildirir.
SearchVehicle, bir geziyle eşleşen bir araç döndürdüğünde sisteminiz, NEW gezisine atadığınız araç kimliğini bildirmek için UpdateTrip uç noktasını çağırır.
|
| 3 |
Seyahati güncelleyin. |
Sürücü yolculuğu kabul edip teslim alma konumuna gitmeye başladığında sisteminiz yolculuk durumunu NEW'dan ENROUTE_TO_PICKUP'ye günceller. Yolculuk boyunca araç konumunu yoklamaya devam edersiniz. Bunu, uygulamadan arka uçunuza doğrudan bağlantı kurarak veya sürücü SDK'sından sürekli olarak araç konumu güncellemeleri alan Fleet Engine'i yoklayarak yapabilirsiniz. Sisteminiz daha sonra yolculuğun her aşamasını Fleet Engine'e bildirir. Fleet Engine de aracın yol noktası listesini buna göre günceller.
|
| 4 |
Yolculuğu tüketiciyle paylaşın. |
Fleet Engine, yolculuk ayrıntılarını ve araç konumunu Consumer SDK'da kullanılabilir hâle getirir. Consumer SDK, yolculuk güncellemelerini almak ve bunları tüketici uygulamasında göstermek için bir dinleyici kullanır. Fleet Engine, tahmini varış zamanını, kalan mesafeyi, rotaları ve kalan araç yol noktalarını otomatik olarak günceller. Daha fazla bilgi için Talep üzerine yolculuklarda yolculukları paylaşma başlıklı makaleyi inceleyin. |
| 5 |
Seyahati tamamlayın. |
Araç, seyahatin hedef ara noktasına ulaştığında ve sürücünüz başarılı bir seyahat olduğunu belirttiğinde sisteminiz Fleet Engine'de TripStatus değerini COMPLETE olarak ayarlar. Araçlar gibi, gezi öğelerinin de durumdan bağımsız olarak 7 gün boyunca Fleet Engine'de etkin kalacağını ve bu sürenin sonunda kaldırılacağını unutmayın. |
Seyahat sırası akışı
Aşağıdaki şemada bu akışın daha ayrıntılı bir görünümü gösterilmektedir.
Sırada ne var?
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 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)"]]
