Tworzenie podróży po kolei

Ten dokument opisuje, jak utworzyć przejazd łączony, ustawić odpowiednie pola i przypisać go do pojazdu, który ma go zrealizować. Zakładamy, że masz skonfigurowany Fleet Engine, utworzone pojazdy, działającą aplikację dla kierowców i opcjonalnie aplikację użytkownika. Powinnaś 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 podróży

W tej sekcji opisano 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
  • Komunikat CreateTripRequest: tylko gRPC

Pola dotyczące przejazdu

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

Pola dotyczące 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 Fleet Engine i mieć te same role konta usługi.
trip_id Tak Utworzony przez Ciebie ciąg znaków, który jednoznacznie identyfikuje dany przejazd. Identyfikatory przejazdów podlegają pewnym ograniczeniom, które są opisane w dokumentacji.
trip_type Tak Ustaw TripType na te wartości dla typu przejazdu, który tworzysz:
  • Pojedyncze miejsce docelowe: ustaw na SHARED lub EXCLUSIVE.
  • Multi-destination (Wiele miejsc docelowych): ustaw wartość EXCLUSIVE.
  • Back-to-back (Jedna po drugiej): ustaw na EXCLUSIVE.
  • Wspólne miejsce na dane: ustawiono na SHARED.
pickup_point Tak Punkt początkowy przejazdu.
Miejsca pośrednie Tak

Tylko przejazdy z wieloma miejscami docelowymi: lista miejsc docelowych, które kierowca odwiedza między odbiorem a wysiadaniem. 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 pośrednie przypisanego pojazdu, a także punkty odbioru i wysiadki dla tego przejazdu. Możesz ustawić to pole, wywołując CreateTrip lub UpdateTrip. Możesz też zaktualizować punkty pośrednie pojazdu w polu waypoints, wywołując UpdateVehicle. Ze względu na ochronę prywatności usługa nie zwraca tych informacji w przypadku wywołań GetTrip.
number_of_passengers Nie Liczba pasażerów podczas przejazdu.
dropoff_point Nie Miejsce docelowe podróży.
vehicle_id Nie Identyfikator pojazdu przypisanego do przejazdu.

Przykład: tworzenie przejazdu łączonego

Poniżej pokazujemy, jak utworzyć przejazd łączony i przypisać go do pojazdu. W tym scenariuszu tworzenie podróży przebiega tak samo jak w przypadku przejazdu do jednego miejsca docelowego. Dopiero później tworzysz kolejny przejazd i przypisujesz go do pojazdu, który ma już aktywny przejazd.

// 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 przejazdów łączonych

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

Każdy przejazd utworzony w Fleet Engine musi być przypisany do pojazdu, aby Fleet Engine mógł obliczyć szacowany czas dotarcia na miejsce i śledzić przejazd. Możesz to zrobić podczas tworzenia przejazdu lub później, gdy go aktualizujesz.

Po przypisaniu przejazdu do pojazdu Fleet Engine automatycznie dodaje punkty pośrednie powiązane z przejazdami łączonymi do pola punktów pośrednich 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.

Załóżmy, że masz 2 następujące po sobie przejazdy: Przejazd A i Przejazd B. Pojazd odebrał klienta w ramach przejazdu A i w drodze do miejsca docelowego kierowca otrzymuje prośbę o odebranie innego klienta w ramach kolejnego przejazdu, czyli przejazdu 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, które zawierają:
    wysiadanie.
  • Wywołanie zwrotne getTrip() lub onTripRemainingWaypointsUpdated dla przejazdu B zwraca remainingWaypoints, które zawierają:
    wysiadkę w ramach przejazdu A → odbiór w ramach przejazdu B → i wysiadkę w ramach przejazdu B.

Co dalej?