지도 설정

플랫폼 선택: Android iOS

소비자 앱에서 이동 경로를 추적하려면 먼저 지도를 정의하고 필요한 경우 벡터 지도 지원을 추가해야 합니다.

앱에서 지도를 설정하려면 다음 단계를 따르세요.

  1. 경로를 따라가는 지도 프래그먼트 정의
  2. 지도 기본 레이어 및 뷰 컨트롤러 지원 추가
  3. 필요한 경우 벡터 지도를 표시하기 위해 Android 벡터 그래픽 지원을 추가합니다.

지도를 정의한 후에는 시각적 환경을 맞춤설정할 보기와 카메라 컨트롤을 추가할 수 있습니다. 자세한 내용은 지도 스타일 지정을 참고하세요.

1단계: 경로를 따라갈 지도 프래그먼트 정의

지도 프래그먼트 또는 뷰를 추가하여 지도 앱을 정의하고 소비자 앱에서 주문형 이동을 공유하는 지도를 만듭니다. 지도를 정의하려면 다음 방법 중 하나를 따르세요.

  • ConsumerMapFragment: Fragment로 지도를 정의하는 데 사용합니다.

  • ConsumerMapView: View로 맵을 정의하는 데 사용합니다.

두 방법의 기능은 동일하므로 애플리케이션에 더 적합한 방법을 선택하세요.

두 가지 방법 모두 다음 섹션에서 자세히 설명합니다.

지도 프래그먼트 또는 뷰 추가

Android 프래그먼트 또는 뷰를 사용하여 경로 진행률을 표시하는 지도를 만들려면 다음 단계를 따르고 코드 예시를 참고하세요.

  1. /res/layout에 있는 애플리케이션 레이아웃 XML 파일에서 프래그먼트 또는 뷰를 정의합니다. 경로 지도를 ConsumerMapFragment를 사용하는 프래그먼트로 정의하거나 ConsumerMapView를 사용하는 뷰로 정의합니다.

    그러면 프래그먼트 또는 뷰가 앱에서 액세스하고 수정할 수 있는 경로 지도에 대한 액세스를 제공합니다. 또한 지도에는 ConsumerController 핸들이 제공되므로 앱에서 소비자 환경을 제어하고 맞춤설정할 수 있습니다.

  2. onCreate() 메서드에서 getConsumerGoogleMapAsync(callback)를 호출합니다. 그러면 콜백에서 ConsumerGoogleMap가 비동기식으로 반환됩니다.

  3. ConsumerGoogleMap를 사용하여 이동 진행률을 표시하고 필요에 따라 업데이트합니다.

ConsumerMapFragment를 추가하는 방법의 예

  1. 다음 코드 예와 같이 애플리케이션 레이아웃 XML 파일에서 프래그먼트를 정의합니다.

    <fragment
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
    android:id="@+id/consumer_map_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

  2. onCreate() 메서드에서 getConsumerGoogleMapAsync()를 호출합니다.

자바

 public class SampleAppActivity extends AppCompatActivity {

   @Override
   protected void onCreate(Bundle savedInstanceState) {

     // Find the ConsumerMapFragment.
     ConsumerMapFragment consumerMapFragment =
         (ConsumerMapFragment) fragmentManager.findFragmentById(R.id.consumer_map_fragment);

     // Initiate the callback that returns the map.
     if (consumerMapFragment != null) {
       consumerMapFragment.getConsumerGoogleMapAsync(
           new ConsumerMapReadyCallback() {
             // The map returned in the callback is used to access the ConsumerController.
             @Override
             public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
               ConsumerController consumerController = consumerGoogleMap.getConsumerController();
             }
           });
     }
   }

 }

Kotlin

 class SampleAppActivity : AppCompatActivity() {
   override fun onCreate(savedInstanceState: Bundle?) {
     // Find the ConsumerMapFragment.
     val consumerMapFragment =
       fragmentManager.findFragmentById(R.id.consumer_map_fragment) as ConsumerMapFragment

     consumerMapFragment.getConsumerGoogleMapAsync(
       object : ConsumerMapReadyCallback() {
         override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
           val consumerController = consumerGoogleMap.getConsumerController()!!
         }
       }
     )
   }
 }

ConsumerMapView를 추가하는 방법의 예

  1. XML 파일에 정의된 대로 프래그먼트 또는 활동에서 뷰를 사용합니다.

     <com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapView
     xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/consumer_map_view"
     android:layout_width="match_parent"
     android:layout_height="match_parent" />

  2. onCreate()에서 getConsumerGoogleMapAsync()를 호출합니다. 콜백 매개변수 외에도 다음 세부정보를 포함합니다.

    • 포함된 활동 또는 프래그먼트 활동 또는 프래그먼트 기본 클래스는 수명 주기에 대한 액세스를 제공하므로 각각 FragmentActivity 또는 지원 Fragment이어야 합니다.

    • MapView의 구성 속성을 포함하는 GoogleMapOptions (null일 수 있음)

자바

public class SampleAppActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ConsumerMapView mapView = findViewById(R.id.consumer_map_view);

    if (mapView != null) {
      mapView.getConsumerGoogleMapAsync(
          new ConsumerMapReadyCallback() {
            // The map returned in the callback is used to access the ConsumerController.
            @Override
            public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
              ConsumerController consumerController = consumerGoogleMap.getConsumerController();
            }
          }, this, null);
    }
  }

}

Kotlin

class SampleAppActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

    mapView.getConsumerGoogleMapAsync(
      object : ConsumerMapReadyCallback() {
        // The map returned in the callback is used to access the ConsumerController.
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          val consumerController = consumerGoogleMap.getConsumerController()!!
        }
      },
      /* fragmentActivity= */ this,
      /* googleMapOptions= */ null,
    )
  }
}

프래그먼트의 MapView는 활동의 MapView에 관한 이전 예와 동일하지만, 프래그먼트가 프래그먼트 onCreateView() 메서드에 MapView를 포함하는 레이아웃을 확장한다는 점을 제외하고는 동일합니다.

자바

public class MapViewInFragment extends Fragment {

  @Override
  public View onCreateView(
      @NonNull LayoutInflater layoutInflater,
      @Nullable ViewGroup viewGroup,
      @Nullable Bundle bundle) {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false);
  }

}

Kotlin

class MapViewInFragment : Fragment() {
  override fun onCreateView(
    layoutInflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?,
  ): View {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false)
  }
}

2단계: 지도 기본 레이어 및 뷰 컨트롤러 지원 추가

앱에서 이동 상황을 공유하려면 앱에 ConsumerGoogleMap 및 ConsumerController 클래스를 추가합니다.

  • ConsumerMapFragment 또는 ConsumerMapView에서 ConsumerGoogleMap를 가져옵니다. 둘 다 ConsumerMapReadyCallback에서 ConsumerGoogleMap를 비동기식으로 반환합니다.

    ConsumerGoogleMap는 GoogleMap 클래스의 래퍼 클래스입니다. 앱이 지도와 상호작용할 수 있도록 GoogleMap와 동일한 API를 사용합니다. 이렇게 하면 앱이 동일한 기본 Google 지도와 원활하게 상호작용할 수 있습니다. 예를 들어 GoogleMap는 단일 콜백 등록만 허용하지만 ConsumerGoogleMap는 이중 등록 콜백을 지원합니다. 이러한 콜백을 사용하면 앱에서 순차적으로 호출되는 콜백을 등록할 수 있습니다.

  • getConsumerController()에서 ConsumerGoogleMap의 ConsumerController을 가져옵니다.

    ConsumerController는 이동 모니터링, 이동 상태 제어, 위치 설정과 같은 이동 공유 기능에 대한 액세스를 제공합니다.

Java 및 Kotlin에서 앱에 ConsumerGoogleMap 및 ConsumerController를 추가하는 방법은 다음 예를 참고하세요.

자바

private ConsumerGoogleMap consumerGoogleMap;
private ConsumerController consumerController;
private ConsumerMapView consumerMapView;

consumerMapView.getConsumerGoogleMapAsync(
    new ConsumerMapReadyCallback() {
      @Override
      public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerMap) {
        consumerGoogleMap = consumerMap;
        consumerController = consumerMap.getConsumerController();
      }
    },
    this, null);

Kotlin

var consumerGoogleMap: ConsumerGoogleMap
var consumerController: ConsumerController
val consumerMapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

consumerMapView.getConsumerGoogleMapAsync(
  object : ConsumerMapReadyCallback() {
    override fun onConsumerMapReady(consumerMap: ConsumerGoogleMap) {
      consumerGoogleMap = consumerMap
      consumerController = consumerMap.getConsumerController()
    },
    /* fragmentActivity= */ this,
    /* googleMapOptions= */ null,
  }
)

3단계: Android 벡터 그래픽 지원 추가

앱 디자인에 벡터 그래픽 지원이 필요한 경우 다음 단계에 따라 Android 기기 및 벡터 드로어블 지원을 추가하세요.

  1. Activity에 다음 코드를 추가합니다. 이 코드는 AppCompatActivity를 확장하여 소비자 SDK에서 벡터 드로어블을 사용합니다.

자바

// ...
import android.support.v7.app.AppCompatActivity;

// ...

public class ConsumerTestActivity extends AppCompatActivity {
  // ...
}

Kotlin

// ...
import android.support.v7.app.AppCompatActivity

// ...

class ConsumerTestActivity : AppCompatActivity() {
  // ...
}

다음 단계

Android에서 이동 경로 추적하기

지도 스타일 지정하기