Bu sayfa, Cloud Translation API ile çevrilmiştir.

Paylaşılan havuz gezileri oluşturma

Bu dokümanda, paylaşılan havuz gezisinin nasıl oluşturulacağı ve doğru değerin nasıl ayarlanacağı açıklanmaktadır. ve doldurulması için bir araca atayın. Filoyu kurduğunuz varsayılır Motor, araçlar oluşturdunuz, çalışan bir sürücü uygulamanız var ve isteğe bağlı olarak bir tüketici uygulaması. Ayrıca, farklı geziler hakkında bilgi sahibi isteğe bağlı seyahatler için birkaç senaryo mevcuttur. Aşağıdakiler için aşağıdaki ilgili kılavuzlara bakın: şu bilgileri sağlar:

Fleet Engine'i kurma
Araç oluşturma
Seç-izle geziler'e genel bakıştaki seyahat senaryoları

Gezi oluşturmayla ilgili temel bilgiler

Bu bölümde, Londra'da seyahat oluşturmak için gereken istek ayrıntıları Filo Motoru. gRPC veya REST kullanarak bir oluşturma isteği gönderirsiniz.

CreateTrip() yöntemi: gRPC veya REST
CreateTripRequest mesajı: Yalnızca gRPC

Gezi Alanları

Fleet Engine'de gezi oluşturmak için aşağıdaki alanları kullanın. Farklı veri türleri için farklı seyahat türlerine yönelik alanlar sunar: tek veya çok hedefli, ortak havuz gezileri olabilir. Siz isteğe bağlı alanları geziyi oluştururken sağlayabilir veya bunları ya da siz de bu sırada gezinebilirsiniz.

Seyahat alanları
Ad	Zorunlu mu?	Açıklama
parent	Evet	Proje kimliğini içeren bir dize. Bu kimlik, kullanılan kimlikle aynı olmalıdır aynı hizmet hesabını kullanarak, Fleet Engine entegrasyonunuzun tamamında rolleriyle birlikte çalışır.
trip_id	Evet	Sizin oluşturduğunuz ve bu seyahati benzersiz şekilde tanımlayan bir dize. Gezi kimlikleri referansta belirtildiği şekilde bazı kısıtlamalara tabi olacaktır.
trip_type	Evet	TripType'ı, oluşturduğunuz gezi türü için aşağıdaki değerlere ayarlayın: Tek hedef: `SHARED` veya `EXCLUSIVE` olarak ayarlayın. Çok hedef: `EXCLUSIVE` olarak ayarlayın. Back-to-back: `EXCLUSIVE` değerine ayarlanır. Shared Pooling (Paylaşılan havuz): `SHARED` olarak ayarlayın.
pickup_point	Evet	Yolculuğun kalkış noktası.
Orta seviye hedefler	Evet	Yalnızca çok hedefli geziler: Sürücün arada ziyaret ettiği ara hedeflerin listesi yardımcı olur. `dropoff_point` olduğu gibi bu alan da daha sonra da ayarlanabilir ancak çok hedefli bir arama yapıldığında `UpdateTrip` tanımı gereği ara hedefler içerir.
vehicle_waypoints	Evet	Yalnızca ortak havuz gezileri: Bu alan, birden fazla seyahatteki ara noktaların arasına katılmayı destekler. Burada, atanan aracın kalan tüm ara noktaları da olarak ayarlayabilirsiniz. Bu alanı, `CreateTrip` veya `UpdateTrip` numaralı telefonu arayarak. Ayrıca transkriptinizi `waypoints` alanındaki araç ara noktalarını bir `UpdateVehicle` numaralı telefona sesli arama yapın. Hizmet `GetTrip` aramalarında bu bilgileri döndürmez izin verilebilir.
number_of_passengers	Hayır	Seyahatteki yolcu sayısı.
dropoff_point	Hayır	Gezinin varış noktası.
vehicle_id	Hayır	Seyahate atanan aracın kimliği.

Örnek: paylaşılan havuz gezisi oluşturma

Aşağıdaki arka uç entegrasyon örneği, seyahatin nasıl oluşturulacağını ve ortak havuz gezisi olarak bir araca atayabilir.

// Vehicle with VEHICLE_ID ID is already created and it is assigned Trip A.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "shared-trip-A";
static final String VEHICLE_ID = "your-vehicle-id";
static final String TRIP_A_ID = "trip-a-id";
static final String TRIP_B_ID = "trip-b-id";

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

LatLng tripBPickup =
    LatLng.newBuilder().setLatitude(-12.12314).setLongitude(88.142123).build();
LatLng tripBDropoff =
    LatLng.newBuilder().setLatitude(-14.12314).setLongitude(90.142123).build();

TerminalLocation tripBPickupTerminalLocation =
    TerminalLocation.newBuilder().setPoint(tripBPickup).build();
TerminalLocation tripBDropoffTerminalLocation =
    TerminalLocation.newBuilder().setPoint(tripBDropoff).build();

// TripA already exists and it's assigned to a vehicle with VEHICLE_ID ID.
Trip tripB = Trip.newBuilder()
    .setTripType(TripType.SHARED)
    .setVehicleId(VEHICLE_ID)
    .setPickupPoint(tripBPickupTerminalLocation)
    .setDropoffPoint(tripBDropoffTerminalLocation)
    .addAllVehicleWaypoints(
        // This is where you define the arrival order for unvisited waypoints.
        // If you don't specify an order, then the Fleet Engine adds Trip B's
        // waypoints to the end of Trip A's.
        ImmutableList.of(
            // Trip B's pickup point.
            TripWaypoint.newBuilder()
                .setLocation(tripBPickupTerminalLocation)
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
                .build(),
            // Trip A's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripA.getDropoffPoint())
                .setTripId(TRIP_A_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build(),
            // Trip B's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripBDropoffTerminalLocation)
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build()))
    .build();

// Create Trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_B_ID)
    .setTrip(tripB)
    .build();

try {
  // createdTrip.remainingWaypoints will contain shared-pool waypoints.
  // [tripB.pickup, tripA.dropoff, tripB.dropoff]
  Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

Paylaşılan havuz gezilerini güncelle

Fleet Engine'de oluşturulan tüm yolculuklar bir araca atanarak Fleet Engine'i kullanarak seyahat tahmini varış sürelerini hesaplayıp takip edebilir. Bu işlemi veya daha sonra, geziyi güncellediğinizde oluşturabilirsiniz.

Paylaşılan havuz gezileri için ziyaret edilmeyen ara noktalara bir sıra belirtmeniz gerekir seyahatin araç ara noktaları koleksiyonunda (Trip.vehicle_waypoints) yer alır. Filo Motor, bu listeyi tüm seyahatler için yolculuk ara noktalarını otomatik olarak güncellemek amacıyla kullanır havuzda kullanabilirsiniz.

Örneğin, A Gezisi ve B Gezisi:

A Gezisi, indirme konumuna doğru yola çıkar.
Ardından aynı araca B Gezisi eklenir.

B Gezisi için bir UpdateTripRequest içinde, vehicleId ve ayrıca Trip.vehicle_waypoints öğesini optimum ara nokta sırası: B _{Teslim alma} → _Ayrılma → B _Ayrılma.

getVehicle() araması yapıldığında remainingWaypoints değeri döndürülür şunları içeren:
B _{Teslim alma} → Bir _Ayrılma → B _Ayrılma.
getTrip() veya Şunun için onTripRemainingWaypointsUpdated geri arama: A gezisi remainingWaypoints tarihinde dönüyor şunları içeren:
B _{Teslim alma} → A _Ayrılma.
getTrip() veya Şunun için onTripRemainingWaypointsUpdated geri arama: B gezisi remainingWaypoints tarihinde dönüyor şunu içeren:
B _{Teslim alma} → _Ayrılma → B _Ayrılma.

Örnek

Aşağıdaki arka uç entegrasyon örneği, bir geziyi araç kimliğini ve ortak havuz yolculuklarının ara noktalarını gösterir.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_A_ID = "share-trip-A";
static final String TRIP_B_ID = "share-trip-B";
static final String VEHICLE_ID = "Vehicle";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_B_ID;

// Get Trip A and Trip B objects from either the Fleet Engine or storage.
Trip tripA = …;
Trip tripB = …;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// The trip settings to update.
Trip trip = Trip.newBuilder()
    .setVehicleId(VEHICLE_ID)
    .addAllVehicleWaypoints(
        // This is where you define the arrival order for unvisited waypoints.
        // If you don't specify an order, then the Fleet Engine adds Trip B's
        // waypoints to the end of Trip A's.
        ImmutableList.of(
            // Trip B's pickup point.
            TripWaypoint.newBuilder()
                .setLocation(tripB.getPickupPoint())
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
                .build(),
            // Trip A's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripA.getDropoffPoint())
                .setTripId(TRIP_A_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build(),
            // Trip B's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripB.getDropoffPoint())
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build()))
    .build();

// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
    .setName(tripName)
    .setTrip(trip)
    .setUpdateMask(FieldMask.newBuilder()
        .addPaths("vehicle_id")
        .addPaths("vehicle_waypoints"))
    .build();

// Error handling. If Fleet Engine has both a trip and vehicle with the IDs,
// and if the credentials validate, and if the given vehicle_waypoints list
// is valid, then the service updates the trip.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:          // Either the trip or vehicle does not exist.
      break;
    case PERMISSION_DENIED:
      break;
    case INVALID_REQUEST:    // vehicle_waypoints is invalid.
      break;
  }
  return;
}

Sırada ne var?

Sürücü SDK'sını ayarlama