Z tego dokumentu dowiesz się, jak utworzyć przejazd do jednego miejsca docelowego, ustawić odpowiednie pola i przypisać go do pojazdu, który ma go zrealizować. Zakładamy, że masz skonfigurowaną flotę jeśli masz utworzone pojazdy, działającą aplikację kierowcy, opcjonalnie aplikację konsumencką. Możesz to sprawdzić w tych powiązanych przewodnikach:
Podstawowe informacje o tworzeniu podróży
W tej sekcji opisano szczegóły żądania, które są niezbędne do utworzenia przejazdu w Fleet Engine. Wysyłasz żądanie utworzenia za pomocą gRPC lub REST.
Pola podróży
Użyj poniższych pól, aby utworzyć podróż we Fleet Engine. Możesz użyć różnych pola dla różnych rodzajów podróży: pojedynczej lub wielu miejsc docelowych, lub wspólne podróże. Ty może wypełnić pola opcjonalne podczas tworzenia podróży lub można je ustawić później, gdy zaktualizujesz podróż.
Nazwa | Wymagany? | Opis |
---|---|---|
parent | Tak | Ciąg tekstowy zawierający identyfikator projektu. Ten identyfikator musi być taki sam, jak używany w całej integracji Fleet Engine z tym samym kontem usługi role. |
trip_id | Tak | Utworzony przez Ciebie ciąg znaków jednoznacznie identyfikujący tę podróż. Identyfikatory podróży zawierają pewnych ograniczeń, które określono w pliku referencyjnym. |
trip_type | Tak | W polu TripType ustaw następujące wartości dla tworzonego typu podróży:
|
pickup_point | Tak | Punkt początkowy podróży. |
Średnie miejsca docelowe | Tak | Tylko podróże do wielu miejsc docelowych: lista pośrednich miejsc docelowych, które kierowca odwiedza pomiędzy tymi miejscami.
odbiór i zwrot. Tak jak |
vehicle_waypoints | Tak | Tylko w przypadku przejazdów współdzielonych: to pole obsługuje przeplatanie punktów pośrednich z różnych przejazdów.
Zawiera wszystkie pozostałe punkty pośrednie dla przypisanego pojazdu, a także punkty odbioru i zwrotu w ramach tej podróży. Możesz wybrać to pole
zadzwoń pod numer |
number_of_passengers | Nie | Liczba pasażerów na trasie. |
dropoff_point | Nie | Cel podróży. |
vehicle_id | Nie | Identyfikator pojazdu przypisanego do podróży. |
Przykład: podróż z jednym celem
Poniższy przykład pokazuje, jak utworzyć podróż do Wielkiej Indonezji
w centrum handlowym East Mall. Podróż obejmuje 2 pasażerów, jest wyłączna i ma status
NEW
provider_id
podróży musi być taki sam jak w Google Cloud
identyfikator projektu. Przykłady pokazują projekt Google Cloud z identyfikatorem projektu
my-rideshare-co-gcp-project
Ten projekt musi też zawierać konto usługi
żeby wywołać Fleet Engine. Więcej informacji znajdziesz w sekcji Role na koncie usługi.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip initial settings.
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE) // Use TripType.SHARED for carpooling.
.setPickupPoint( // Grand Indonesia East Mall.
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setNumberOfPassengers(2)
// Provide the drop-off point if available.
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId("trip-8241890") // Trip ID assigned by the provider.
.setTrip(trip) // The initial state is NEW.
.build();
// Error handling.
try {
Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}