Android 스튜디오 프로젝트 설정

Android용 Places SDK를 사용하도록 앱을 구성하려면 다음 단계를 따르세요. Android용 Places SDK를 사용하는 모든 앱에 필요합니다.

1단계: Android 스튜디오 설정하기

  1. Android 스튜디오 Arctic Fox 이상이 필요합니다. 아직 다운로드하지 않은 경우 다운로드하고 설치하세요.
  2. Android 스튜디오에서 Android Gradle 플러그인 버전 7.0 이상을 사용 중이어야 합니다.

2단계: SDK 설정

Android용 Places SDK 라이브러리는 Google Maven 저장소를 통해 사용할 수 있습니다. 앱에 SDK를 추가하려면 다음 지침을 따르세요.

  1. 최상위 수준 settings.gradle 파일의 pluginManagement 블록 아래 Gradle 플러그인 포털, Google Maven 저장소, Maven 중앙 저장소를 포함합니다. pluginManagement 블록은 스크립트의 모든 문 앞에 표시되어야 합니다.
    pluginManagement {
        repositories {
            gradlePluginPortal()
            google()
            mavenCentral()
        }
    } 
  2. 최상위 수준 settings.gradle 파일의 dependencyResolutionManagement 블록 아래에 Google Maven 저장소Maven 중앙 저장소를 포함합니다.
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. 모듈 수준 build.gradle 파일의 dependencies 섹션에서 Android용 Places SDK에 종속 항목을 추가합니다.

    dependencies {
        implementation 'com.google.android.libraries.places:places:3.0.0'
    }
    
  4. 모듈 수준 build.gradle 파일에서 compileSdkminSdk를 다음 값으로 설정합니다.
    android {
        compileSdk 31
    
        defaultConfig {
            minSdk 21
            // ...
        }

3단계: 프로젝트에 API 키 추가

이 섹션에서는 앱이 더욱 안전하게 참조할 수 있도록 API 키를 저장하는 방법을 설명합니다. API 키는 버전 제어 시스템에 등록하면 안 되며, 프로젝트의 루트 디렉터리에 있는 local.properties 파일에 저장하는 것이 좋습니다. local.properties 파일에 관한 자세한 내용은 Gradle 속성 파일을 참고하세요.

이 작업을 간소화하려면 Android용 Secrets Gradle 플러그인을 사용하는 것이 좋습니다. 플러그인을 설치하여 API 키를 저장하는 방법은 다음과 같습니다.

  1. Android 스튜디오에서 프로젝트 수준 build.gradle 파일을 열고 다음 코드를 buildscript 아래 dependencies 요소에 추가합니다.
    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
    }
  2. 그런 다음 모듈 수준 build.gradle 파일을 열고 plugins 요소에 다음 코드를 추가합니다.
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
        
  3. 파일을 저장하고 프로젝트를 Gradle과 동기화합니다.
  4. 프로젝트 수준 디렉터리에서 local.properties를 열고 다음 코드를 추가합니다. YOUR_API_KEY를 API 키로 변경합니다.
    MAPS_API_KEY=YOUR_API_KEY
        
  5. 파일을 저장합니다.
  6. AndroidManifest.xml 파일에서 com.google.android.geo.API_KEY로 이동한 후 android:value attribute를 다음과 같이 업데이트합니다.
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />
        

참고: 위의 내용처럼, com.google.android.geo.API_KEY는 API 키의 권장 메타데이터 이름입니다. 이 이름의 키를 사용하여 Android용 Places SDK를 비롯한 Android 플랫폼의 여러 Google 지도 기반 API를 인증할 수 있습니다. 이전 버전과의 호환성을 위해 API에서는 com.google.android.maps.v2.API_KEY 이름도 지원합니다. 이 기존 이름을 사용하면 Android 지도 API v2만 인증할 수 있습니다. 애플리케이션에서는 API 키 메타데이터 이름을 하나만 지정할 수 있습니다. 두 개가 모두 지정되면 API에서 예외가 발생합니다.

4단계. Places API 클라이언트 초기화

다음 예와 같이 활동 또는 프래그먼트 내에서 Android용 Places SDK를 초기화합니다. Places.initialize()를 호출할 때 API 키를 전달합니다.

자바


    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

      

Kotlin


    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

      

이제 Android용 Places SDK를 사용할 준비가 되었습니다.

5단계: Android 기기 설정하기

Android용 Places SDK를 사용하는 앱을 실행하려면 Google API를 포함하는 Android 4.0 이상의 Android 기기 또는 에뮬레이터에 Android용 Places SDK를 배포해야 합니다.

  • Android 기기를 사용하려면 하드웨어 기기에서 앱 실행의 안내를 따르세요.
  • Android Emulator를 사용하려면 Android 스튜디오와 함께 제공되는 Android Virtual Device(AVD) Manager를 이용해 가상 기기를 만들고 에뮬레이터를 설치할 수 있습니다.

다음 단계

프로젝트가 구성되면 샘플 앱을 살펴볼 수 있습니다.