Android Driver SDK 3.0 이전 가이드

Android용 Driver SDK 3.0 출시에서는 특정 작업에 관한 코드를 업데이트해야 합니다. 이 가이드에서는 변경사항과 코드를 이전하기 위해 취해야 할 조치를 간략히 설명합니다.

패키지 이름 변경

패키지 이름이 com.google.android.libraries.ridesharing.driver에서 com.google.android.libraries.mapsplatform.transportation.driver로 변경되었습니다. 코드의 참조를 업데이트하세요.

SDK 초기화

이전 버전에서는 Navigation SDK를 초기화한 다음 FleetEngine 클래스의 참조를 가져왔습니다. Driver SDK v3에서 다음과 같이 SDK를 초기화합니다.

  1. NavigationApi에서 Navigator 객체를 가져옵니다.

    NavigationApi.getNavigator(
      this, // Activity
      new NavigationApi.NavigatorListener() {
        @Override
        public void onNavigatorReady(Navigator navigator) {
          // Keep a reference to the Navigator (used to configure and start nav)
          this.navigator = navigator;
        }
      }
);

  2. DriverContext 객체를 만들고 필수 입력란을 채웁니다.

    DriverContext driverContext = DriverContext.builder(application)
             .setProviderId(providerId)
             .setVehicleId(vehicleId)
             .setAuthTokenFactory(authTokenFactory)
             .setNavigator(navigator)
             .setRoadSnappedLocationProvider(
                 NavigationApi.getRoadSnappedLocationProvider(application))
             .build()

  3. DriverContext 객체를 사용하여 *DriverApi를 초기화합니다.

  4. API 객체에서 NavigationVehicleReporter를 가져옵니다. *VehicleReporter는 NavigationVehicleReporter를 확장합니다.

위치 업데이트 사용 설정 및 중지

이전 버전에서는 FleetEngine 참조를 가져온 후에 위치 업데이트를 사용 설정했습니다. Driver SDK v3에서 다음과 같이 위치 업데이트를 사용 설정합니다.

보고 간격을 업데이트하려면 RidesharingVehicleReporter.setLocationReportingInterval(long, TimeUnit) 또는 DeliveryVehicleReporter.setLocationReportingInterval(long, TimeUnit)를 사용하세요.

운전자의 교대 근무가 완료되면 위치 업데이트를 사용 중지하고 NavigationVehicleReporter.disableLocationTracking()를 호출하여 차량을 오프라인으로 표시합니다.

StatusListener를 사용한 오류 보고

ErrorListener가 삭제되고 StatusListener와 결합되었으며 다음과 같이 정의될 수 있습니다.

class MyStatusListener implements StatusListener {
  /** Called when background status is updated, during actions such as location reporting. */
  @Override
  public void updateStatus(
    StatusLevel statusLevel,
    StatusCode statusCode,
    String statusMsg) {
    // Status handling stuff goes here.
    // StatusLevel may be DEBUG, INFO, WARNING, or ERROR.
    // StatusCode may be DEFAULT, UNKNOWN_ERROR, VEHICLE_NOT_FOUND, 
    // BACKEND_CONNECTIVITY_ERROR, or PERMISSION_DENIED.
  }
}