GitHub의 Android용 Maps SDK 저장소에는 Android 앱에서 Android용 Maps SDK를 사용하는 방법을 보여주는 샘플이 포함되어 있습니다.
저장소에는 단일 Android 앱에서 샘플을 빌드하고 실행할 수 있는 ApiDemos 앱이 포함되어 있습니다. 앱을 가져와 빌드하고, API 키를 추가하고, 데모를 보고, 앱의 시작점으로 제공된 샘플 코드를 사용하세요.
샘플 앱을 실행하면 기기에서 실행할 수 있는 샘플 목록이 표시됩니다. 옵션 중 하나를 선택합니다. 예를 들어 기본 지도를 클릭합니다.
문제 해결: 샘플 앱이 실행되었지만 지도가 표시되지 않으면 API 키 사용에 설명된 대로 API 키를 앱의 매니페스트 파일에 추가했는지 확인하세요.
Android용 Maps SDK 샘플 앱 목록
Android용 Maps SDK ApiDemos 앱에 포함된 주요 샘플 활동은 아래에 나와 있으며 빠른 참조를 위해 연결된 페이지에서 재현됩니다. 사용 가능한 샘플의 전체 목록은 Kotlin 또는 Java 폴더를 참고하세요.
샘플 클론 및 실행
이 샘플을 로컬로 실행하려면 Git가 필요합니다. 다음 명령어는 샘플 애플리케이션 저장소를 클론합니다.
git clone git@github.com:googlemaps-samples/android-samples.git
샘플 프로젝트를 Android 스튜디오로 가져옵니다.
- Android 스튜디오에서 File > New > Import Project를 선택합니다.
저장소를 저장한 위치로 이동하여 Kotlin 또는 Java를 위한 프로젝트 디렉터리를 선택합니다.
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- 열기를 선택합니다. Android 스튜디오에서 Gradle 빌드 도구를 사용하여 프로젝트를 빌드합니다.
- 프로젝트의
local.properties
파일과 동일한 디렉터리에서 빈secrets.properties
파일을 만듭니다. 자세한 내용은 프로젝트에 직접 생성한 API 키 추가하기를 참고하세요. 다음 문자열을
secrets.properties
에 추가합니다(YOUR_API_KEY는 API 키의 값으로 변경).MAPS_API_KEY=YOUR_API_KEY
- 앱을 실행합니다.
Wear OS에 표시되는 지도의 샘플 앱
Wear OS에 표시되는 Android용 Maps SDK의 샘플 앱은 GitHub에 있으며, 이를 바탕으로 웨어러블 앱을 빌드할 수 있습니다. 샘플에서는 Wear OS에서 기본 Google 지도를 설정하는 방법을 보여줍니다.