Android용 Maps SDK 유틸리티 설정

플랫폼 선택: Android iOS

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

사전 요구사항 및 참고 사항

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

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

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

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

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

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

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

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

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

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}

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

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

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

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

  • demo 디렉터리에 있는 데모 애플리케이션
  • library 디렉터리에 있는 유틸리티 라이브러리
  • 라이선스, 참여자, 리드미를 포함한 다양한 파일
  • Android 스튜디오에서 사용할 Gradle 빌드 구성

유틸리티 데모 앱 실행

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

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

    MAPS_API_KEY=YOUR_API_KEY

    여기서 YOUR_API_KEYAPI 키 사용에 설명된 대로 가져온 API 키입니다.

  6. 데모 앱 빌드 및 실행

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