Bu bölümde, aracın gezilere nasıl hazırlanacağı gösterilmektedir. Arka uç sunucunuz bir aracı bir seyahatle eşleştirebilmesi için aşağıdaki adımların her birini tamamlamanız gerekir.
Dinleyiciyi ayarlama
Sürücü SDK'sı arka planda işlem gerçekleştirdiğinden, hata, uyarı veya hata ayıklama mesajları gibi belirli etkinlikler gerçekleştiğinde bildirimleri tetiklemek için DriverStatusListener simgesini kullanın. Hatalar geçici olabilir (BACKEND_CONNECTIVITY_ERROR gibi) veya konum güncellemelerinin kalıcı olarak durmasına neden olabilir. Örneğin, VEHICLE_NOT_FOUND hatası alırsanız bu bir yapılandırma hatası olduğunu gösterir.
Aşağıdaki örnekte bir DriverStatusListener uygulaması gösterilmektedir:
class MyStatusListener implements DriverStatusListener {
/** Called when background status is updated, during actions such as location reporting. */
@Override
public void updateStatus(
StatusLevel statusLevel, StatusCode statusCode, String statusMsg, @Nullable Throwable cause) {
// Existing implementation
if (cause != null && cause instanceof StatusRuntimeException) {
if (Status.NOT_FOUND.getCode().equals(cause.getStatus().getCode())) {
// NOT_FOUND gRPC exception thrown by Fleet Engine.
}
}
}
}
DriverContextBuilder.setDriverStatusListener(new MyStatusListener());
Konum güncellemelerini etkinleştirme
Dinleyiciyi ayarladıktan sonra konum güncellemelerini aşağıdaki gibi etkinleştirin:
Java
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
Kotlin
val reporter = ...
reporter.enableLocationTracking()
Güncelleme aralığını ayarlama
Sürücü SDK'sı, araç durumu ONLINE olduğunda varsayılan olarak 10 saniyelik aralıklarla konum güncellemeleri gönderir. Bu aralığı reporter.setLocationReportingInterval(long, TimeUnit) ile değiştirebilirsiniz. Desteklenen minimum güncelleme aralığı 5 saniyedir. Daha sık güncelleme, isteklerin yavaşlamasına ve hatalara neden olabilir.
Araç durumunu "online" olarak ayarlama
Konum güncellemelerini etkinleştirdiğinizde, aracı Fleet Engine'da SearchVehicles sorguları için kullanılabilir hale getirmek üzere araç durumunu ONLINE olarak ayarlayabilirsiniz. Sürücü SDK'sı, konum güncellemeleriyle birlikte güncellenmiş araç durumunu gönderir.
Araç durumunu doğrudan Driver SDK'sında veya Fleet Engine sunucusunda ayarlayabilirsiniz. Daha fazla bilgi için Araç güncelleme başlıklı makaleyi inceleyin.
Aşağıdaki örneklerde, Driver SDK'sında araç durumunun nasıl online olarak ayarlanacağı gösterilmektedir:
Java
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
reporter.setVehicleState(VehicleState.ONLINE);
Kotlin
val reporter = ...
reporter.enableLocationTracking()
reporter.setVehicleState(VehicleState.ONLINE)
StatusListener, araç durumu güncellenirken oluşan hataları da bildirir.