Создайте поездку в один пункт назначения

В этом документе описывается, как создать одну поездку в пункт назначения, задать правильные поля и назначить ее транспортному средству для выполнения. Предполагается, что вы настроили Fleet Engine, создали транспортные средства, имеете работающее приложение для водителей и, при необходимости, потребительское приложение. Для этого обратитесь к следующим соответствующим руководствам:

Основы создания поездок

В этом разделе описаны детали запроса, необходимые для создания поездки в Fleet Engine. Вы отправляете запрос на создание, используя gRPC и REST.

  • Метод CreateTrip() : gRPC или REST
  • Сообщение CreateTripRequest : только gRPC

Поля поездки

Используйте следующие поля, чтобы создать поездку в Fleet Engine. Вы можете использовать разные поля для разных типов поездок: поездки с одним или несколькими пунктами назначения, попутные поездки или групповые поездки. Вы можете указать необязательные поля при создании поездки или установить их позже, при обновлении поездки.

Поля поездки
Имя Необходимый? Описание
родитель Да Строка, включающая идентификатор проекта. Этот идентификатор должен совпадать с тем же идентификатором, который используется во всей вашей интеграции Fleet Engine, с теми же ролями учетной записи службы.
trip_id Да Созданная вами строка, которая однозначно идентифицирует эту поездку. Идентификаторы поездок имеют определенные ограничения, как указано в справке.
тип_путешествия Да Установите для TripType следующие значения для создаваемого типа поездки:
  • Один пункт назначения : установите значение SHARED или EXCLUSIVE .
  • Несколько пунктов назначения : установите значение EXCLUSIVE .
  • Взаимно : установите значение EXCLUSIVE .
  • Общий пул : установите значение SHARED .
точка_подачи Да Начальная точка поездки.
Промежуточные направления Да

Только поездки с несколькими пунктами назначения : список промежуточных пунктов назначения, которые водитель посещает между посадкой и высадкой. Как и в случае с dropoff_point , это поле также можно установить позже, вызвав UpdateTrip , но поездка с несколькими пунктами назначения по определению содержит промежуточные пункты назначения.

Vehicle_waypoints Да

Только для поездок с общим пулом : это поле поддерживает чередование путевых точек из нескольких поездок. Он содержит все оставшиеся путевые точки для назначенного транспортного средства, а также путевые точки посадки и высадки для этой поездки. Вы можете установить это поле, вызвав CreateTrip или UpdateTrip . Вы также можете обновить путевые точки транспортного средства через поле waypoints с помощью вызова UpdateVehicle . Служба не возвращает эту информацию при звонках GetTrip по соображениям конфиденциальности.

количество_пассажиров Нет Количество пассажиров в поездке.
dropoff_point Нет Пункт назначения поездки.
идентификатор транспортного средства Нет Идентификатор транспортного средства, назначенного для поездки.

Пример: поездка в один пункт назначения.

В следующем примере показано, как создать поездку в торговый центр Grand Indonesia East. Поездка предполагает двух пассажиров, является эксклюзивной и имеет статус NEW . provider_id поездки должен совпадать с идентификатором проекта Google Cloud. В примерах показан проект Google Cloud с идентификатором проекта my-rideshare-co-gcp-project . Этот проект также должен включать сервисную учетную запись для вызова Fleet Engine. Подробности см. в разделе Роли учетной записи службы .

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;
}

Что дальше