Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Fleet Engine udostępnia punkt końcowy SearchTripsRequest, którego możesz używać do wyszukiwania przejazdów. W tym dokumencie opisujemy 2 sytuacje, w których możesz użyć tej funkcji.
Więcej informacji o gRPC znajdziesz w SearchTripsRequest, a o REST – w trips.Search.
Określanie aktywnych przejazdów pojazdu
Aby znaleźć aktywne przejazdy dla określonych pól, użyj wiadomości SearchTripsRequest, aby ustawić vehicle_id na rozpatrywany pojazd i ustawić active_trips_only na true.
Uzgodnij dostępność pojazdów między systemem a Fleet Engine
W niektórych sytuacjach możesz zobaczyć wyniki zwrócone przez SearchVehicles, które nie odpowiadają pojazdom dostępnym w Twoim systemie i flocie. Dzieje się tak, ponieważ SearchVehicles nie wyświetla pojazdów z aktywnymi przejazdami lub obniża ich pozycję w rankingu wyników. Jedną z przyczyn tego problemu jest sytuacja, w której pojazdy zakończyły przejazdy, ale stan przejazdu nie został prawidłowo ustawiony na COMPLETE lub CANCELED. Używając SearchTrips do wyszukiwania otwartych przejazdów, możesz oceniać pojazdy, aby mieć pewność, że TripStatus w Twoim systemie odpowiada temu w Fleet Engine.
Aby użyć SearchTrips w ten sposób, w SearchTripsRequest
wiadomości ustaw:
Pole vehicle_id powinno być puste.
Wartość active_trips_only powinna wynosić true.
minimum_staleness powinien być czasem dłuższym niż większość podróży, np. godziną.
Wyniki takiego żądania obejmują przejazdy, które nie są ani COMPLETE, ani CANCELED i nie były aktualizowane od ponad godziny. Następnie możesz sprawdzić te przejazdy, aby upewnić się, że ich stan w Fleet Engine jest prawidłowo aktualizowany.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-04 UTC."],[[["\u003cp\u003eFleet Engine's \u003ccode\u003eSearchTripsRequest\u003c/code\u003e helps find trips, useful for identifying active trips and reconciling vehicle availability.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eSearchTripsRequest\u003c/code\u003e with \u003ccode\u003evehicle_id\u003c/code\u003e and \u003ccode\u003eactive_trips_only\u003c/code\u003e to find a specific vehicle's active trips.\u003c/p\u003e\n"],["\u003cp\u003eDiscrepancies between your system and Fleet Engine's vehicle availability can be addressed by using \u003ccode\u003eSearchTripsRequest\u003c/code\u003e to identify open trips and ensure trip statuses are synchronized.\u003c/p\u003e\n"],["\u003cp\u003eTrips older than 7 days are automatically deleted in Fleet Engine.\u003c/p\u003e\n"]]],["The `SearchTripsRequest` endpoint in Fleet Engine allows finding trips, focusing on two scenarios. First, setting `vehicle_id` and `active_trips_only` to `true` identifies active trips for a specific vehicle. Second, to reconcile vehicle availability, `vehicle_id` is left empty, `active_trips_only` is `true`, and `minimum_staleness` is set to over an hour. This identifies open, outdated trips (neither `COMPLETE` nor `CANCELED`) for status reconciliation. Trips are only searchable for seven days.\n"],null,["Fleet Engine provides the `SearchTripsRequest` endpoint that you can use to find\ntrips. This document describes two scenarios where you might use this feature.\n\nSee `SearchTripsRequest` for [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#searchtripsrequest) or `trips.Search` for [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips/search).\n| **Note:** Trips remain active in Fleet Engine for 7 days, after which they are deleted, so `SearchTrips` only shows trips that have been active within the past 7 days.\n\nDetermine active trips for a vehicle\n\nTo do find the active trips for a specific fields, use the `SearchTripsRequest`\nmessage to set the `vehicle_id` to the vehicle under consideration and set\n`active_trips_only` to `true`.\n\nReconcile vehicle availability between your system and Fleet Engine\n\nIn some situations, you might see results returned by `SearchVehicles` that\ndon't correspond with the vehicles you know to be available in your system and\nyour fleet. This happens because `SearchVehicles` either doesn't show vehicles\nwith active trips, or pushes them down in the results ranking. One cause of this\nis when vehicles have completed trips, but the trip status not been properly set\nto either `COMPLETE` or `CANCELED`. By using `SearchTrips` to find open trips,\nyou can evaluate vehicles to ensure that `TripStatus` in your system matches\nthat of Fleet Engine.\n\nTo use `SearchTrips` in this way, set the following in the `SearchTripsRequest`\nmessage:\n\n- `vehicle_id` should be empty.\n- `active_trips_only` should be `true`.\n- `minimum_staleness` should be a time greater than most trip durations; for example, one hour.\n\nThe results of such a request include Trips that are neither `COMPLETE` nor\n`CANCELED`, and have not been updated in over an hour. You can then examine\nthese trips to ensure that their status in Fleet Engine is properly updated.\n\nWhat's next\n\n- [Delete Trip](/maps/documentation/mobility/fleet-engine/journeys/trips/delete-trip)"]]
