기존 Android 스튜디오 프로젝트 설정하기

이 페이지에서는 빠른 시작에 자세히 설명되어 있는 Google 지도 템플릿을 사용하지 않고 Android용 Maps SDK를 사용하도록 Android 스튜디오 프로젝트를 구성하는 방법을 설명합니다.

Google 지도 템플릿은 자동으로 기본 지도를 구성하고 새 Android 스튜디오 프로젝트에 추가합니다. 하지만 다른 Android 스튜디오 템플릿을 사용하는 Android 프로젝트에 지도를 추가할 수도 있습니다. 이렇게 하려면 프로젝트를 수동으로 구성한 다음 지도를 추가해야 합니다.

Android 스튜디오 설정하기

  1. Android 스튜디오는 필수입니다. 아직 다운로드하지 않은 경우 다운로드하고 설치하세요.

  2. Android 스튜디오에 Google Play 서비스 SDK를 추가합니다. Android용 Maps SDK는 Google Play 서비스 SDK 중 일부로 배포되며, SDK Manager를 통해 추가할 수 있습니다.

Cloud 프로젝트 및 API 키 설정하기

Cloud 프로젝트와 API 키를 설정하려면 다음을 수행합니다.

앱 매니페스트 업데이트하기

이 섹션에서는 AndroidManifest.xml 파일에 추가할 설정을 설명합니다.


Google Play 서비스 버전 번호

application 요소 내에 다음 선언을 추가합니다. 이렇게 하면 앱이 컴파일된 Google Play 서비스의 버전이 삽입됩니다.

<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

위치 권한

앱에서 사용자의 위치에 액세스해야 하는 경우 AndroidManifest.xml 파일에서 위치 권한을 요청해야 합니다. 정확한 사용자 위치를 제공하는 ACCESS_FINE_LOCATION과 정확도가 떨어지는 ACCESS_COARSE_LOCATION을 선택할 수 있습니다. 자세한 내용은 위치 데이터 가이드를 참조하세요.

ACCESS_FINE_LOCATION 권한을 요청하려면 이 코드를 manifest 요소에 추가하세요.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

외부 저장소 권한

Google Play 서비스 SDK 버전 8.3 이상을 타겟팅하는 경우에는 WRITE_EXTERNAL_STORAGE 권한이 필요하지 않습니다. 이전 버전의 Google Play 서비스 SDK를 타겟팅하는 경우에는 manifest 요소에서 WRITE_EXTERNAL_STORAGE 권한을 요청해야 합니다.

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Apache HTTP Legacy 라이브러리

com.google.android.gms:play-services-maps:16.0.0 이하를 사용 중이고 앱이 API 수준 28(Android 9.0) 이상을 타겟팅하는 경우 AndroidManifest.xml<application> 요소 내에 다음 선언을 포함해야 합니다. 그렇지 않다면 이 선언을 건너뛰세요.

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

지도의 종속 항목 추가하기

앱 수준 build.gradle 파일에 지도의 종속 항목을 추가합니다. 자세한 내용은 버전 관리 가이드를 참조하세요.

dependencies {
    implementation 'com.google.android.gms:play-services-maps:17.0.1'
    // ...
}

다음 단계

프로젝트가 구성되면 지도를 추가할 수 있습니다.