Birden çok varış noktası içeren geziler oluşturun

Bu dokümanda, çok hedefli bir seyahatin nasıl oluşturulacağı, doğru alanların nasıl ayarlanacağı ve seyahatin yerine getirilmesi için bir araca nasıl atanacağı açıklanmaktadır. Bu eğitimde, Fleet Engine'ı kurduğunuz, araç oluşturduğunuz, çalışan uygulaması ve isteğe bağlı olarak tüketici uygulamasına sahip olduğunuz varsayılmaktadır. Ayrıca, isteğe bağlı seyahatler için kullanılabilen çeşitli seyahat senaryolarını da bilmeniz gerekir. Aşağıdaki ilgili kılavuzları inceleyin:

• Fleet Engine'u kurma
• Araç oluşturma
• Araç çağırma seyahatlerine genel bakıştaki seyahat senaryoları

Gezi oluşturmayla ilgili temel bilgiler

Bu bölümde, Fleet Engine'da gezi oluşturmak için gerekli istek ayrıntıları açıklanmaktadır. gRPC ve REST'i kullanarak bir oluşturma isteği gönderirsiniz.

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

Not: CreateTrip()'i kullanmak için Fleet Engine: Hizmet hesabı rolleri bölümünde belirtilen ayrıcalıklı hesabın kimlik bilgilerine sahip olmanız gerekir.

Seyahat Alanları

Fleet Engine'da gezi oluşturmak için aşağıdaki alanları kullanın. Farklı seyahat türleri için farklı alanlar kullanabilirsiniz: tek veya çok hedefli, art arda yapılan veya ortak havuz seyahatleri. İsteğe bağlı alanları geziyi oluştururken sağlayabilir veya geziyi güncellerken daha sonra ayarlayabilirsiniz.

Seyahat alanları

Ad	Zorunlu mu?	Açıklama
parent	Evet	Proje kimliğini içeren bir dize. Bu kimlik, Fleet Engine entegrasyonunuzun tamamında kullanılan ve aynı hizmet hesabı rolleriyle aynı kimlik olmalıdır.
trip_id	Evet	Bu geziyi benzersiz bir şekilde tanımlayan, sizin oluşturduğunuz bir dize. Seyahat kimliklerinde, referans bölümünde belirtildiği gibi belirli kısıtlamalar vardır.
trip_type	Evet	Oluşturduğunuz seyahat türü için TripType parametresini aşağıdaki değerlere ayarlayın: Tek hedef: SHARED veya EXCLUSIVE olarak ayarlayın. Çok hedefli: EXCLUSIVE olarak ayarlayın. Arka arkaya: EXCLUSIVE olarak ayarlayın. Ortak havuz: SHARED olarak ayarlanır.
pickup_point	Evet	Seyahatin kalkış noktası.
Orta düzey hedefler	Evet	Yalnızca çok hedefli seyahatler: Sürücünün, alma ve bırakma noktası arasında ziyaret ettiği ara hedeflerin listesi. dropoff_point ile olduğu gibi bu alan, UpdateTrip çağrılarak daha sonra da ayarlanabilir ancak çok hedefli seyahatler, tanımı gereği ara hedefler içerir.
vehicle_waypoints	Evet	Yalnızca ortak havuzdaki seyahatler: Bu alan, birden fazla seyahatteki yol noktalarının birbirine karıştırılmasını destekler. Atanmış araç için kalan tüm yol noktalarının yanı sıra bu seyahatin teslim alma ve bırakma yol noktalarını içerir. Bu alanı CreateTrip veya UpdateTrip numarasını arayarak ayarlayabilirsiniz. Araç yol işaretlerini UpdateVehicle çağrısı yaparak waypoints alanı üzerinden de güncelleyebilirsiniz. Hizmet, gizlilik nedeniyle GetTrip aramalarında bu bilgileri döndürmez.
number_of_passengers	Hayır	Gezideki yolcu sayısı.
dropoff_point	Hayır	Seyahatin varış noktası.
vehicle_id	Hayır	Geziye atanan aracın kimliği.

Örnek: Birden fazla hedefi olan bir gezi oluşturma

Aşağıda, bir teslim alma noktası, bir teslim etme noktası ve bir ara hedefi olan özel çok hedefli bir seyahatin nasıl oluşturulacağı gösterilmektedir.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// Trip initial settings.
String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setNumberOfPassengers(1)
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    // Add the list of intermediate destinations.
    .addAllIntermediateDestinations(
        ImmutableList.of(
            TerminalLocation.newBuilder().setPoint(
                LatLng.newBuilder()
                    .setLatitude(-6.195139).setLongitude(106.820826)).build()))
    .build();

// Create the Trip request.
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)  // Trip ID assigned by the Provider server.
    .setTrip(trip)       // 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:  // Trip already exists.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

Birden çok hedefi olan bir geziyi güncelleme

Fleet Engine'ın aracı rotasında izleyebilmesi için geziyi bir araç kimliğiyle yapılandırmanız gerekir. Bir geziyi güncelleme hakkında ayrıntılı bilgi için Gezileri güncelleme ve durumlarını yönetme başlıklı makaleyi inceleyin.

Yolculuğu oluştururken bırakma veya ara hedefler belirtmezseniz bunu dilediğiniz zaman bu aşamada yapabilirsiniz.

Not: Bir gezi için intermediate_destinations değerini ayarladığınızda veya güncellediğinizde Fleet Engine, oluşturulan gezi öğesinde intermediate_destinations_version değerini doldurur. Bu alanı sisteminizde önbelleğe almanız ve daha sonra intermediate_destination_index'yi güncellediğinizde UpdateTripRequest değerini iletmeniz gerekir. Bu sayede, ara hedefler sürücü istemciniz ile Fleet Engine arasında senkronize edilir.

Örnek gezi güncellemesi

Aşağıda, bir seyahatin nasıl güncellenerek ara varış noktalarının listesinin eklenmesi ve araç kimliğinin ayarlanması gösterilmektedir.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";

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

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// The trip settings to be updated.
Trip trip = Trip.newBuilder()
    // Add the list of intermediate destinations.
    .addAllIntermediateDestinations(
        ImmutableList.of(
            TerminalLocation.newBuilder().setPoint(
                LatLng.newBuilder()
                    .setLatitude(-6.195139).setLongitude(106.820826)).build()))
    .setVehicleId("8241890")
    .build();

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

// Error handling.
try {
  Trip updatedTrip =
      tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

Birden fazla hedefi olan seyahatler için seyahat durumunu yönetme

TripStatus listeleme değerlerinden birini kullanarak seyahatin durumunu belirtirsiniz. Bir seyahatin durumu değiştiğinde (ör. ENROUTE_TO_PICKUP yerine ARRIVED_AT_PICKUP) Fleet Engine'da seyahat durumunu güncellemeniz gerekir. Gezi durumu her zaman NEW değeriyle başlar ve COMPLETE veya CANCELED değeriyle biter.

Birden fazla hedefi olan bir gezi için, gezi durumunu tek hedefli bir gezi için yaptığınız gibi güncellemenin yanı sıra aracınız her ara hedefe ulaştığında aşağıdakileri de güncellemeniz gerekir:

• intermediateDestinationIndex
• intermediateDestinationsVersion

Bunu yapmak için TripStatus dize listesinden aşağıdaki değerleri kullanın.

• ENROUTE_TO_PICKUP
• ARRIVED_AT_PICKUP
• ENROUTE_TO_INTERMEDIATE_DESTINATION
• ARRIVED_AT_INTERMEDIATE_DESTINATION
• ENROUTE_TO_DROPOFF
• COMPLETE

Not: Seyahat, her ara hedef için hem ENROUTE_TO_INTERMEDIATE_DESTINATION hem de ARRIVED_AT_INTERMEDIATE_DESTINATION üzerinden bir kez geçmelidir.

Ara hedefler içeren örnek gezi

Aşağıda, teslim alma noktasını geçmiş ve şu anda ilk ara hedefine giden çok hedefli bir seyahatin nasıl oluşturulacağı gösterilmektedir.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";

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

// Get the trip object from either the Fleet Engine or storage.
Trip trip = …;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// The trip settings to be updated.
Trip trip = Trip.newBuilder()
    // Trip status cannot return to a previous state once it has passed.
    .setTripStatus(TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION)

    // Enroute to the first intermediate destination.
    .setIntermediateDestinationIndex(0)

    // You must provide an intermediate_destinations_version to ensure that you
    // have the same intermediate destinations list as the Fleet Engine.
    .setIntermediateDestinationsVersion(
         trip.getIntermediateDestinationsVersion())
    .build();

// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
    .setName(tripName)
    .setTrip(trip)
    .setUpdateMask(
        FieldMask.newBuilder()
            .addPaths("trip_status")
            .addPaths("intermediate_destination_index")
            // intermediate_destinations_version must not be in the update mask.
            .build())
    .build();

// Error handling.
try {
  Trip updatedTrip =
      tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case FAILED_PRECONDITION:  // Either the trip status is invalid, or the
                               // intermediate_destinations_version doesn't
                               // match Fleet Engine's.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

Sırada ne var?

• Arka arkaya geziler oluşturma
• Sürücü SDK'sını ayarlama