Android'de bir geziyi takip etme

Bir geziyi takip ettiğinizde tüketici uygulamanız, tüketiciye uygun aracın konumunu gösterir. Bunu yapmak için uygulamanızın bir geziyi takip etmeye başlaması, gezi ilerlemesini güncellemesi ve gezi tamamlandığında takibi durdurması gerekir.

Bu belgede, söz konusu sürecin işleyiş şekli açıklanmaktadır.

Başlamadan önce

Aşağıdaki ayarları yaptığınızdan emin olun:

• Tüketici uygulamanızın arka uç hizmetleri mevcut ve tüketicileri araçlarla eşleştirme hizmetleriniz çalışıyor.

• Uygulamanız için bir harita oluşturmuş olmanız gerekir.

Bir geziyi takip etmeye başlama

Arka uç sunucunuz bir tüketiciyi araçla eşleştirdiğinde, yolculuğu takip etmeye başlamak için JourneySharingSession kullanın.

Aşağıdaki örnek kod, görünüm yüklendikten sonra bir geziyi takip etmeye nasıl başlayacağınızı gösterir.

public class MainActivity extends AppCompatActivity
    implements ConsumerViewModel.JourneySharingListener  {

  // Class implementation

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Create a TripModel instance to listen for updates to the trip specified by this trip name.
    String tripName = ...;
    TripModelManager tripModelManager = consumerApi.getTripModelManager();
    TripModel tripModel = tripModelManager.getTripModel(tripName);

    // Create a JourneySharingSession instance based on the TripModel.
    JourneySharingSession session = JourneySharingSession.createInstance(tripModel);

    // Add the JourneySharingSession instance on the map for updating the UI.
    consumerController.showSession(session);

    // Register for trip update events.
    tripModel.registerTripCallback(new TripModelCallback() {
      @Override
      public void onTripETAToNextWaypointUpdated(
          TripInfo tripInfo, @Nullable Long timestampMillis) {
        // ...
      }

      @Override
      public void onTripActiveRouteRemainingDistanceUpdated(
          TripInfo tripInfo, @Nullable Integer distanceMeters) {
        // ...
      }

      // ...
    });
  }

  @Override
  protected void onDestroy() {
    super.onDestroy();

    if (journeySharingSession != null) {
      journeySharingSession.stop();
    }
  }
}

class SampleAppActivity : AppCompatActivity(), ConsumerViewModel.JourneySharingListener {

  // Class implementation

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Create a TripModel instance to listen for updates to the trip specified by this trip name.
    val tripName = "tripName"
    val tripModelManager = consumerApi.getTripModelManager()
    val tripModel = tripModelManager.getTripModel(tripName)

    // Create a JourneySharingSession instance based on the TripModel.
    val session = JourneySharingSession.createInstance(tripModel)

    // Add the JourneySharingSession instance on the map for updating the UI.
    consumerController.showSession(session)

    // Register for trip update events.
    tripModel.registerTripCallback(
      object : TripModelCallback() {
        override fun onTripETAToNextWaypointUpdated(
          tripInfo: TripInfo,
          timestampMillis: Long?,
        ) {
          // ...
        }

        override fun onTripActiveRouteRemainingDistanceUpdated(
          tripInfo: TripInfo,
          distanceMeters: Int?,
        ) {
          // ...
        }

      // ...
    })
  }

  override fun onDestroy() {
    super.onDestroy()

    journeySharingSession?.stop()
  }
}

Gezi ilerleme durumunu güncelleme

Aracın varıştan önce gitmesi gereken mesafe ve tahmini varış zamanı gibi seyahat ilerleme durumu ayrıntılarını güncellemek için uygulamanızın aşağıdaki örneklerde gösterildiği gibi bir dinleyici kaydetmesi ve yapılandırması gerekir.

1. Bir TripModel nesnesine işleyici kaydedin.

   Java

   // Create a TripModel instance for listening to updates to the trip specified by this trip name.
   String tripName = ...;
   TripModelManager tripModelManager = consumerApi.getTripModelManager();
   TripModel tripModel = tripModelManager.getTripModel(tripName);
   
   // Create a JourneySharingSession instance based on the TripModel.
   JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
   
   // Add the JourneySharingSession instance on the map for updating the UI.
   consumerController.showSession(session);
   
   // Register for trip update events.
   tripModel.registerTripCallback(new TripModelCallback() {
   @Override
   public void onTripETAToNextWaypointUpdated(
           TripInfo tripInfo, @Nullable Long timestampMillis) {
         // ...
   }
   
   @Override
   public void onTripActiveRouteRemainingDistanceUpdated(
           TripInfo tripInfo, @Nullable Integer distanceMeters) {
         // ...
   }
   
   // ...
   });
   

   Kotlin

   // Create a TripModel instance for listening to updates to the trip specified by this trip name.
   val tripName = "tripName"
   val tripModelManager = consumerApi.getTripModelManager()
   val tripModel = tripModelManager.getTripModel(tripName)
   
   // Create a JourneySharingSession instance based on the TripModel.
   val session = JourneySharingSession.createInstance(tripModel)
   
   // Add the JourneySharingSession instance on the map for updating the UI.
   consumerController.showSession(session)
   
   // Register for trip update events.
   tripModel.registerTripCallback(
     object : TripModelCallback() {
       override fun onTripETAToNextWaypointUpdated(
         tripInfo: TripInfo,
         timestampMillis: Long?,
       ) {
         // ...
       }
   
       override fun onTripActiveRouteRemainingDistanceUpdated(
         tripInfo: TripInfo,
         distanceMeters: Int?,
       ) {
         // ...
       }
   
     // ...
   })
   

2. TripModelOptions kullanarak geziniz için dinleyiciyi yapılandırın.

   Java

   // Set refresh interval to 2 seconds.
   TripModelOptions tripOptions =
         TripModelOptions.builder().setRefreshIntervalMillis(2000).build();
   tripModel.setTripModelOptions(tripOptions);
   

   Kotlin

   // Set refresh interval to 2 seconds.
   val tripOptions = TripModelOptions.builder().setRefreshIntervalMillis(2000).build()
   tripModel.setTripModelOptions(tripOptions)
   

Gezileri takip etmeyi bırakma

Uygulamanızın, artık gerekmediğinde (ör. sürücü tarafından arka uçta gezinin TAMAMLANDI olarak işaretlenmesi) gezileri takip etmeyi bıraktığından emin olun. Yolculuk paylaşımını durdurmak, Fleet Engine'e gereksiz ağ istekleri gönderilmesini önler ve bellek sızıntılarını engeller.

Aşağıdaki örnek kodda gösterildiği gibi, geziyi takip etmeyi durdurmak için JourneySharingSession kullanın.

public class MainActivity extends AppCompatActivity
    implements ConsumerViewModel.JourneySharingListener  {

  // Class implementation

  @Override
  protected void onDestroy() {
    super.onDestroy();

    if (journeySharingSession != null) {
      journeySharingSession.stop();
    }
  }
}

class SampleAppActivity : AppCompatActivity(), ConsumerViewModel.JourneySharingListener {

  // Class implementation

  override fun onDestroy() {
    super.onDestroy()

    journeySharingSession?.stop()
  }
}

Seyahat hatalarını giderme

onTripRefreshError yöntemi, yolculuk izleme sırasında oluşan hataları gösterir. Hata mesajları, Google Cloud Error standardına uygundur. Ayrıntılı hata mesajı tanımları ve tüm hata kodları için Google Cloud Hataları belgelerine bakın.

Seyahat izleme sırasında oluşabilecek bazı yaygın hatalar şunlardır:

Tüketici SDK'sı Hatalarını İşleme

Consumer SDK, geri çağırma mekanizmasını kullanarak seyahat güncelleme hatalarını tüketici uygulamasına gönderir. Geri çağırma parametresi, platforma özgü bir dönüş türüdür ( TripUpdateError Android'de ve NSError iOS'te).

Ayıklama durum kodları

Geri çağırmaya iletilen hatalar genellikle gRPC hatalarıdır ve bunlardan durum kodu şeklinde ek bilgiler de çıkarabilirsiniz. Durum kodlarının tam listesi için Durum kodları ve gRPC'de kullanımları başlıklı makaleyi inceleyin.

// Called when there is a trip update error.
@Override
public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
  Status.Code code = error.getStatusCode();
}

// Called when there is a trip update error.
override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
  val code = error.getStatusCode()
}

Durum kodlarını yorumlama

Durum kodları iki tür hatayı kapsar: sunucu ve ağ ile ilgili hatalar ve istemci tarafı hataları.

Sunucu ve ağ hataları

Aşağıdaki durum kodları ağ veya sunucu hatalarıyla ilgilidir ve bunları düzeltmek için herhangi bir işlem yapmanız gerekmez. Consumer SDK, bu hataları otomatik olarak düzeltir.

İstemci hataları

Aşağıdaki durum kodları istemci hataları içindir ve bunları çözmek için işlem yapmanız gerekir. Tüketici SDK'sı, yolculuk paylaşımını sonlandırana kadar yolculuğu yenilemeyi tekrar denemeye devam eder ancak siz işlem yapana kadar kurtarılamaz.