Android에서 여행 팔로우하기

플랫폼 선택: Android iOS JavaScript

여행을 팔로우하면 소비자 앱에 적절한 차량의 위치가 소비자에게 표시됩니다. 이렇게 하려면 앱이 여정을 따라가고, 여정 진행 상황을 업데이트하고, 여정이 완료되면 여정을 따라가는 것을 중지해야 합니다.

이 문서에서는 이 프로세스의 작동 방식을 설명합니다.

시작하기 전에

다음 항목을 설정했는지 확인합니다.

  • 소비자 앱의 백엔드 서비스가 준비되어 있고 소비자와 차량을 매칭하는 서비스가 작동 중입니다.

  • 앱에 지도를 설정했습니다.

여행 팔로우 시작하기

백엔드 서버가 소비자를 차량과 매칭하면 JourneySharingSession를 사용하여 여정을 추적하기 시작합니다.

다음 샘플 코드는 뷰가 로드된 후 여행을 팔로우하는 방법을 보여줍니다.

자바

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();
    }
  }
}

Kotlin

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()
  }
}

이동 경로 진행 상황 업데이트

도착 전 차량 이동 거리, 예상 도착 시간과 같은 여정 진행 상황 세부정보를 업데이트하려면 앱이 다음 예와 같이 리스너를 등록하고 구성해야 합니다.

  1. TripModel 객체에 리스너를 등록합니다.

    자바

    // 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를 사용하여 여행의 리스너를 구성합니다.

    자바

    // 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)

여행 팔로우 중지하기

앱이 더 이상 필요하지 않은 경우(예: 운전자가 백엔드에서 여정을 완료로 표시한 경우) 앱이 여정을 추적하지 않도록 합니다. 여정 공유를 중지하면 Fleet Engine에 대한 불필요한 네트워크 요청이 방지되고 메모리 누수가 방지됩니다.

다음 샘플 코드와 같이 JourneySharingSession를 사용하여 여정 추적을 중지합니다.

자바

public class MainActivity extends AppCompatActivity
    implements ConsumerViewModel.JourneySharingListener  {

  // Class implementation

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

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

Kotlin

class SampleAppActivity : AppCompatActivity(), ConsumerViewModel.JourneySharingListener {

  // Class implementation

  override fun onDestroy() {
    super.onDestroy()

    journeySharingSession?.stop()
  }
}

여행 오류 처리

onTripRefreshError 메서드는 여행 모니터링 중에 발생하는 오류를 표시합니다. 오류 메시지는 Google Cloud 오류 표준을 따릅니다. 자세한 오류 메시지 정의와 모든 오류 코드는 Google Cloud 오류 문서를 참고하세요.

다음은 여정 모니터링 중에 발생할 수 있는 일반적인 오류입니다.

HTTP RPC 설명
400 INVALID_ARGUMENT 클라이언트가 잘못된 여행 이름을 지정했습니다. 여행 이름은 providers/{provider_id}/trips/{trip_id} 형식을 따라야 합니다. provider_id는 서비스 제공업체가 소유한 Cloud 프로젝트의 ID여야 합니다.
401 UNAUTHENTICATED 유효한 인증 사용자 인증 정보가 없으면 이 오류가 표시됩니다. 예를 들어 JWT 토큰이 여행 ID 없이 서명되거나 JWT 토큰이 만료된 경우입니다.
403 PERMISSION_DENIED 클라이언트에 충분한 권한이 없거나(예: 소비자 역할의 사용자가 updateTrip을 호출하려고 함) JWT 토큰이 유효하지 않거나 클라이언트 프로젝트에 API가 사용 설정되지 않은 경우 이 오류가 발생합니다. JWT 토큰이 누락되었거나 토큰이 요청된 여정 ID와 일치하지 않는 여정 ID로 서명되었을 수 있습니다.
429 RESOURCE_EXHAUSTED 리소스 할당량이 0이거나 트래픽 비율이 한도를 초과합니다.
503 현재 구매할 수 없음 서비스를 사용할 수 없습니다. 전형적인 서버 다운입니다.
504 DEADLINE_EXCEEDED 요청 기한이 지났습니다. 이 오류는 호출자가 메서드의 기본 기한보다 짧게 기한을 설정한 후 (요청된 기한이 서버가 요청을 처리할 수 있을 만큼 충분히 길지 않아서) 요청이 기한 내에 완료되지 않았을 때 발생합니다.

Consumer SDK 오류 처리

소비자 SDK는 콜백 메커니즘을 사용하여 이동 업데이트 오류를 소비자 앱에 전송합니다. 콜백 매개변수는 플랫폼별 반환 유형(Android의 경우 TripUpdateError, iOS의 경우 NSError)입니다.

상태 코드 추출

콜백에 전달되는 오류는 일반적으로 gRPC 오류이며 상태 코드 형식으로 추가 정보를 추출할 수도 있습니다. 상태 코드의 전체 목록은 gRPC의 상태 코드 및 사용을 참고하세요.

자바

onTripUpdateError()에서 반환된 TripUpdateError에서 오류에 관한 세부정보를 제공하는 gRPC 상태 코드를 추출할 수 있습니다.

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

Kotlin

onTripUpdateError()에서 반환된 TripUpdateError에서 오류에 관한 세부정보를 제공하는 gRPC 상태 코드를 추출할 수 있습니다.

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

상태 코드 해석

상태 코드는 서버 및 네트워크 관련 오류와 클라이언트 측 오류의 두 가지 오류를 다룹니다.

서버 및 네트워크 오류

다음 상태 코드는 네트워크 또는 서버 오류에 해당하며, 이를 해결하기 위해 조치를 취할 필요가 없습니다. 컨슈머 SDK는 이러한 오류에서 자동으로 복구됩니다.

상태 코드설명
ABORTED 서버에서 응답 전송을 중지했습니다. 이 문제는 일반적으로 서버 문제로 인해 발생합니다.
CANCELLED 서버에서 나가는 응답을 종료했습니다. 이는 일반적으로 앱이 백그라운드로 전송되거나
소비자 앱에 상태 변경이 있을 때 발생합니다.
INTERRUPTED
DEADLINE_EXCEEDED 서버가 응답하는 데 시간이 너무 오래 걸렸습니다.
현재 구매할 수 없음 서버를 사용할 수 없습니다. 이 문제는 일반적으로 네트워크 문제로 인해 발생합니다.

클라이언트 오류

다음 상태 코드는 클라이언트 오류에 해당하며, 이를 해결하기 위한 조치를 취해야 합니다. 소비자 SDK는 여정 공유를 종료할 때까지 여행을 새로고침하려고 계속 시도하지만, 사용자가 조치를 취할 때까지 복구되지 않습니다.

상태 코드설명
INVALID_ARGUMENT 소비자 앱에서 잘못된 여정 이름을 지정했습니다. 여정 이름은 providers/{provider_id}/trips/{trip_id} 형식을 따라야 합니다.
NOT_FOUND 이동이 생성되지 않았습니다.
PERMISSION_DENIED 컨슈머 앱에 권한이 부족합니다. 이 오류는 다음과 같은 경우에 발생합니다.
  • 소비자 앱에 권한이 없음
  • Google Cloud 콘솔에서 프로젝트에 Consumer SDK가 사용 설정되어 있지 않습니다.
  • JWT 토큰이 누락되었거나 잘못되었습니다.
  • JWT 토큰이 요청된 이동과 일치하지 않는 이동 ID로 서명되었습니다.
RESOURCE_EXHAUSTED 리소스 할당량이 0이거나 트래픽 흐름 비율이 속도 제한을 초과합니다.
UNAUTHENTICATED 잘못된 JWT 토큰으로 인해 요청 인증이 실패했습니다. 이 오류는 JWT 토큰이 여행 ID 없이 서명되거나 JWT 토큰이 만료된 경우에 발생합니다.