Android용 Maps SDK 유틸리티 설정

이 페이지에서는 Android용 Maps SDK 유틸리티 라이브러리를 설정하고 라이브러리에 포함된 데모 앱을 실행하는 방법을 설명합니다.

사전 요구사항 및 참고 사항

Android용 Maps SDK 유틸리티 라이브러리는 Android API 수준 15 이상을 지원합니다. 프로젝트 빌드 대상을 설정할 때 최신 Android API 수준을 사용하는지 확인하세요.

GitHub에서 참조 문서를 볼 수 있습니다.

1단계: Android용 Maps SDK 유틸리티 라이브러리 설치

앱의 build.gradle 파일에 다음 종속 항목을 추가합니다.

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.2.3'
}

라이브러리에서 마커 클러스터링, 히트맵 또는 기타 유틸리티 등 유틸리티 중 하나를 사용하세요.

2단계: (선택사항) Android용 Maps SDK 유틸리티 KTX 라이브러리 설치

Android용 Maps SDK 유틸리티 라이브러리는 해당 Kotlin 확장 프로그램(KTX) 라이브러리와 함께 제공됩니다. 이 라이브러리에서는 확장 프로그램 기능, 이름이 지정된 기본 인수 등과 같은 Kotlin 언어 기능을 제공하여 간결하고 자연스러운 Kotlin을 작성할 수 있습니다. Kotlin에서 개발하지 않는 경우 이 단계를 건너뛸 수 있습니다.

이 라이브러리를 사용하려면 android-maps-utils 종속 항목 외에 다음 종속 항목을 앱의 build.gradle 파일에 추가하세요.

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.2.1'
}

이 라이브러리에 대한 추가 정보는 Maps KTX GitHub 페이지를 확인하세요.

3단계: Android용 Maps SDK 유틸리티 라이브러리 소스 코드 보기

유틸리티 라이브러리는 오픈소스이므로 android-maps-utils 라이브러리를 머신에 다운로드하여 라이브러리를 맞춤설정하고 데모 앱을 보거나 라이브러리 작동 방식을 파악할 수 있습니다. 저장소를 클론(권장됨, 자동 업데이트 수신)하거나 zip 파일을 다운로드하면 됩니다. 라이브러리를 맞춤설정하려면 저장소를 포크해야 합니다.

저장소는 다음 항목을 포함합니다.

  • demo 디렉터리에 있는 데모 애플리케이션
  • library 디렉터리에 있는 유틸리티 라이브러리
  • library-v3 디렉터리에 있는 Maps SDK v3 베타의 유틸리티 라이브러리
  • 라이선스, 참여자, 추가 정보를 포함한 다양한 파일
  • Android Studio에서 사용할 Gradle 빌드 구성

유틸리티 데모 앱 실행

유틸리티 라이브러리용 GitHub 저장소에는 각 유틸리티의 샘플 구현이 포함된 데모 앱이 함께 제공됩니다. 다음 단계에 따라 Android 기기에서 데모 앱을 실행합니다.

  1. 위에서 언급한 옵션 중 하나를 사용하여 저장소를 다운로드합니다.
  2. Android 스튜디오에서 File(파일) > New(새 파일) > Import Project(프로젝트 가져오기)를 선택합니다.
  3. 유틸리티 라이브러리를 클론했을 때 생성된 android-maps-utils 디렉터리를 찾아 선택(더블클릭)합니다. Android 스튜디오에서 이제 프로젝트를 빌드합니다.
  4. 에뮬레이터 대신 Android 기기를 사용하는 경우 개발자 모드를 사용 설정해야 합니다. 그런 다음 Android 기기를 컴퓨터에 연결합니다.
  5. 데모 앱 빌드 및 실행

Android 기기에서 앱이 열리고 클러스터링, poyutil, 히트맵 등의 유틸리티가 목록으로 표시됩니다. 지도 유틸리티 데모 이름 아래의 앱 목록에 있는 앱을 찾을 수도 있습니다.