이 페이지에서는 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 기기에서 데모 앱을 실행합니다.
- 위에서 언급한 옵션 중 하나를 사용하여 저장소를 다운로드합니다.
- Android 스튜디오에서 File(파일) > New(새 파일) > Import Project(프로젝트 가져오기)를 선택합니다.
- 유틸리티 라이브러리를 클론했을 때 생성된 android-maps-utils 디렉터리를 찾아 선택(더블클릭)합니다. Android 스튜디오에서 이제 프로젝트를 빌드합니다.
- 에뮬레이터 대신 Android 기기를 사용하는 경우 개발자 모드를 사용 설정해야 합니다. 그런 다음 Android 기기를 컴퓨터에 연결합니다.
local.properties
에 다음과 같이 한 줄을 추가합니다.MAPS_API_KEY=YOUR_API_KEY
여기서 YOUR_API_KEY는 API 키 사용에 설명된 대로 가져온 API 키입니다.
- 데모 앱 빌드 및 실행
Android 기기에서 앱이 열리고 클러스터링, poyutil, 히트맵 등의 유틸리티가 목록으로 표시됩니다. 지도 유틸리티 데모 이름 아래의 앱 목록에 있는 앱을 찾을 수도 있습니다.