Tworzenie podróży po kolei

Z tego dokumentu dowiesz się, jak utworzyć przejazd z powrotem, ustawić odpowiednie pola i przypisać go do pojazdu. Zakładamy, że masz już skonfigurowaną usługę Fleet Engine, utworzone pojazdy, działającą aplikację dla kierowców i opcjonalnie aplikację użytkownika. Powinieneś też znać różne scenariusze przejazdów dostępne w przypadku przejazdów na żądanie. Więcej informacji znajdziesz w tych przewodnikach:

Podstawowe informacje o tworzeniu wycieczek

W tej sekcji opisujemy szczegóły żądania niezbędne do utworzenia przejazdu w Fleet Engine. Wysyłasz żądanie utworzenia za pomocą gRPC i REST.

  • Metoda CreateTrip(): gRPC lub REST
  • CreateTripRequest message: gRPC only

Pola przejazdu

Aby utworzyć przejazd w Fleet Engine, użyj tych pól. Możesz używać różnych pól dla różnych rodzajów przejazdów: z jednym lub wieloma miejscami docelowymi, przejazdów łączonych lub przejazdów współdzielonych. Pola opcjonalne możesz wypełnić podczas tworzenia przejazdu lub później, gdy będziesz go aktualizować.

Pola przejazdu
Nazwa Wymagany? Opis
parent Tak Ciąg tekstowy zawierający identyfikator projektu. Ten identyfikator musi być taki sam jak identyfikator używany w całej integracji z Fleet Engine, z tymi samymi rolami konta usługi.
trip_id Tak Utworzony przez Ciebie ciąg znaków, który jednoznacznie identyfikuje tę podróż. Identyfikatory przejazdów podlegają pewnym ograniczeniom, o których mowa w dokumentacji.
trip_type Tak Ustaw wartość TripType na jedną z tych wartości w przypadku tworzonego typu podróży:
  • Pojedyncze miejsce docelowe: ustaw na SHARED lub EXCLUSIVE.
  • Wiele miejsc docelowych: ustaw na EXCLUSIVE.
  • Back-to-back (Jedna po drugiej): ustaw wartość EXCLUSIVE.
  • Pula współdzielona: ustaw na SHARED.
pickup_point Tak Punkt początkowy podróży.
Miejsca docelowe pośrednie Tak

Tylko przejazdy z wieloma miejscami docelowymi: lista miejsc docelowych, które kierowca odwiedza między odbiorem a wysadzeniem pasażera. Podobnie jak w przypadku dropoff_point, to pole można też ustawić później, wywołując UpdateTrip, ale przejazd z wieloma miejscami docelowymi z definicji zawiera miejsca docelowe.
vehicle_waypoints Tak

Tylko przejazdy współdzielone: to pole obsługuje przeplatanie punktów pośrednich z wielu przejazdów. Zawiera wszystkie pozostałe punkty na trasie przypisanego pojazdu, a także punkty odbioru i wysiadki w przypadku tej podróży. Możesz ustawić to pole, dzwoniąc pod numer CreateTrip lub UpdateTrip. Możesz też zaktualizować punkty pośrednie pojazdu za pomocą pola waypoints, wywołując funkcję UpdateVehicle. Ze względu na ochronę prywatności usługa nie zwraca tych informacji w przypadku połączeń GetTrip.
number_of_passengers Nie Liczba pasażerów w przejeździe.
dropoff_point Nie Miejsce docelowe podróży.
vehicle_id Nie Identyfikator pojazdu przypisanego do przejazdu.

Przykład: tworzenie przejazdu bezpośrednio po poprzednim

Poniżej pokazujemy, jak utworzyć przejazd z przesiadką i przypisać go do pojazdu. W tym przypadku tworzenie podróży jest takie samo jak w przypadku wycieczki do jednego miejsca docelowego. Dopiero później możesz utworzyć kolejną podróż i przypisać ją do pojazdu, który ma już aktywną podróż.

// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .setVehicleId(VEHICLE_ID)
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)
    .setTrip(trip)
    .build();

// Error handling.
try {
  // Fleet Engine automatically assigns a 'waypoints' list to the trip containing
  // the vehicle's current trip waypoints.
  Trip createdTrip =
      tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

Aktualizowanie kolejnych przejazdów

Gdy przypisujesz pojazd do przejazdu łączonego, przypisujesz przejazd do pojazdu, nawet jeśli został już do niego przypisany.

Każda podróż utworzona w Fleet Engine musi być przypisana do pojazdu, aby Fleet Engine mógł obliczać szacowany czas przyjazdu i śledzić podróż. Możesz to zrobić podczas tworzenia przejazdu lub później, gdy go zaktualizujesz.

Po przypisaniu przejazdu do pojazdu Fleet Engine automatycznie dodaje punkty trasy powiązane z przejazdami następującymi po sobie do pola punktów trasy pojazdu. Pole remainingWaypoints przejazdu zawiera listę wszystkich punktów pośrednich, w tym tych z innych przejazdów, które zostaną odwiedzone przed zakończeniem przejazdu.

Weźmy na przykład 2 kolejne podróże: Podróż A i Podróż B. Pojazd odebrał klienta w ramach podróży A i w drodze do miejsca docelowego kierowca otrzymuje prośbę o odebranie innego klienta w ramach kolejnej podróży, czyli podróży B.

  • Wywołanie getVehicle() zwraca remainingWaypoints, które zawierają:
    A Wysiadka → B Odbiór → B Wysiadka.
  • Wywołanie zwrotne getTrip() lub onTripRemainingWaypointsUpdated dla przejazdu A zwraca remainingWaypoints zawierające:
    miejsce docelowe.
  • Wywołanie zwrotne getTrip() lub onTripRemainingWaypointsUpdated dla podróży B zwraca remainingWaypoints, które zawierają:
    wysadzenie w podróży A → odebranie w podróży B → i wysadzenie w podróży B.

Co dalej?