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

Bu belgede, çok varış noktalı bir gezi oluşturma, doğru alanları ayarlama ve bunu karşılanacak bir araca atama işlemleri açıklanmaktadır. Fleet Engine'i ayarladığınız, araç oluşturduğunuz, çalışan bir sürücü uygulamanız olduğu ve isteğe bağlı olarak bir tüketici uygulamanız olduğu varsayılır. Ayrıca, isteğe bağlı yolculuklar için sunulan çeşitli yolculuk senaryolarına da aşina olmanız gerekir. Bu konuda aşağıdaki ilgili rehberlere göz atın:

• Fleet Engine'i ayarlama
• Araç oluşturma
• Talep üzerine yolculuklar genel bakışında yolculuk senaryoları

Gezi oluşturmayla ilgili temel bilgiler

Bu bölümde, Fleet Engine'de gezi oluşturmak için gereken 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() kullanmak için Fleet Engine: Hizmet hesabı rolleri bölümünde belirtilen ayrıcalıklı hesabın kimlik bilgileri gerekir.

Seyahat Alanları

Fleet Engine'de seyahat oluşturmak için aşağıdaki alanları kullanın. Tek veya birden fazla varış noktası olan, arka arkaya ya da paylaşımlı yolculuklar gibi farklı türlerdeki yolculuklar için farklı alanlar kullanabilirsiniz. İ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, aynı hizmet hesabı rolleriyle birlikte tüm Fleet Engine entegrasyonunuzda kullanılan kimlikle aynı olmalıdır.
trip_id	Evet	Bu seyahati benzersiz şekilde tanımlayan bir dize oluşturursunuz. Seyahat kimlikleri, referansta belirtildiği gibi belirli kısıtlamalara tabidir.
trip_type	Evet	Oluşturduğunuz gezi türü için TripType'ı aşağıdaki değerlere ayarlayın: Tek hedef: SHARED veya EXCLUSIVE olarak ayarlayın. Çoklu hedef: EXCLUSIVE olarak ayarlayın. Arka arkaya: EXCLUSIVE olarak ayarlayın. Paylaşılan havuz: SHARED olarak ayarlayın.
pickup_point	Evet	Gezinin başlangıç noktası.
Ara hedefler	Evet	Yalnızca çok varış noktalı yolculuklar: Sürücünün yolcu alma ve bırakma arasında ziyaret ettiği ara varış noktalarının listesi. dropoff_point ile aynı şekilde, bu alan daha sonra UpdateTrip çağrılarak da ayarlanabilir ancak tanım gereği çok varış noktalı bir yolculuk ara varış noktaları içerir.
vehicle_waypoints	Evet	Yalnızca ortak yolculuklar: Bu alan, birden fazla yolculuktaki ara noktaların iç içe geçmesini destekler. Atanan araçla ilgili kalan tüm ara noktaların yanı sıra bu seyahatin teslim alma ve bırakma ara noktalarını içerir. Bu alanı CreateTrip veya UpdateTrip numaralı telefonu arayarak ayarlayabilirsiniz. Ayrıca, waypoints alanını kullanarak UpdateVehicle çağrısıyla araç yol noktalarını güncelleyebilirsiniz. Hizmet, gizlilik nedeniyle GetTrip görüşmelerinde bu bilgileri döndürmez.
number_of_passengers	Hayır	Gezideki yolcu sayısı.
dropoff_point	Hayır	Gezinin varış noktası.
vehicle_id	Hayır	Gezintiye atanan aracın kimliği.

Örnek: Birden fazla varış noktası içeren bir gezi oluşturma

Aşağıda, bir teslim alma noktası, bir bırakma noktası ve bir ara hedef içeren özel çok varış noktalı bir gezi oluşturma işlemi 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;
}

Deneysel: Deneysel bir özellik olarak, TerminalLocation (gRPC veya REST) alanı artık place (gRPC veya REST) kullanımını destekliyor. Bu alan, LatLng ile birlikte veya onun yerine kullanılabilir.

Çok varış noktalı bir geziyi güncelleme

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

Gezinizi oluştururken bırakma veya ara varış noktaları belirtmediyseniz bunları her zaman bu aşamada belirtebilirsiniz.

Not: Bir yolculukta intermediate_destinations değerini her ayarladığınızda veya güncellediğinizde Fleet Engine, oluşturulan yolculuk varlığında intermediate_destinations_version değerini doldurur. Bu alanı sisteminizde önbelleğe almanız ve daha sonra intermediate_destination_index alanını güncellediğinizde UpdateTripRequest değerini iletmeniz gerekir. Bu, ara hedeflerin sürücü istemciniz ile Fleet Engine arasında senkronize kalmasını sağlar.

Örnek gezi güncellemesi

Aşağıdaki örnekte, bir geziyi güncelleyerek ara hedefler listesi ekleme ve araç kimliği ayarlama işlemi 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;
}

Deneysel: Deneysel bir özellik olarak, TerminalLocation (gRPC veya REST) alanı artık place (gRPC veya REST) kullanımını destekliyor. Bu alan, LatLng ile birlikte veya onun yerine kullanılabilir.

Çok varış noktalı gezilerde gezi durumunu yönetme

Bir seyahatin durumunu TripStatus numaralandırma değerlerinden birini kullanarak belirtirsiniz. Bir gezinin durumu değiştiğinde (ör. ENROUTE_TO_PICKUP'dan ARRIVED_AT_PICKUP'a) gezi durumunu Fleet Engine'de güncellemeniz gerekir. Seyahat durumu her zaman NEW değeriyle başlar ve COMPLETE veya CANCELED değeriyle biter.

Çok varış noktalı bir gezi için, gezi durumunu tek varış noktalı bir gezide olduğu gibi güncellemenin yanı sıra aracınız her ara varış noktasına ulaştığında aşağıdakileri de güncellemeniz gerekir:

• intermediateDestinationIndex
• intermediateDestinationsVersion

Bunu yapmak için TripStatus numaralandırmasındaki 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: Gezi, her ara hedef için bir kez ENROUTE_TO_INTERMEDIATE_DESTINATION ve ARRIVED_AT_INTERMEDIATE_DESTINATION noktalarından geçmelidir.

Ara hedefleri olan örnek gezi

Aşağıda, teslim alma noktasını geçmiş ve şu anda ilk ara varış noktasına doğru yolda olan çok varış noktalı 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