Google Cloud 콘솔 프로젝트 구성

Android용 소비자 SDK를 사용하도록 Google Cloud 콘솔을 설정하고 구성하려면 다음 단계를 따르세요.

  1. 개발 프로젝트를 설정합니다.
  2. 앱에 소비자 SDK를 추가합니다.
  3. 앱에 API 키를 추가합니다.
  4. 앱에 필요한 저작자 표시를 포함합니다.

각 단계에 관한 자세한 내용은 다음 섹션을 참고하세요.

개발 프로젝트 설정

Google Cloud 콘솔 개발 프로젝트와 이동성 프로젝트의 API 키가 없는 경우 설정해야 합니다. 자세한 내용은 Fleet Engine 가이드의 프로젝트 만들기를 참고하세요.

소비자 SDK의 개발 프로젝트를 선택할 때는 Fleet Engine에 사용 중인 것과 동일한 Google Cloud 콘솔 프로젝트와 API 키를 선택합니다.

앱에 소비자 SDK 추가

소비자 SDK는 Google Maven 저장소에서 사용할 수 있습니다. 저장소에는 SDK의 프로젝트 객체 모델 (.pom) 파일과 Javadoc이 포함됩니다. 앱에 소비자 SDK를 추가하려면 Gradle 또는 Maven 구성에 소비자 SDK 및 Maps SDK 종속 항목을 추가합니다.

다음 예시에서 VERSION_NUMBER를 필요한 버전의 소비자 SDK로 대체합니다.

Gradle

build.gradle에 다음을 추가합니다.

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

pom.xml에 다음을 추가합니다.

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

앱에 API 키 추가

앱에 Consumer SDK를 추가한 후 API 키를 추가합니다. 개발 프로젝트를 설정할 때 획득한 프로젝트 API 키를 사용해야 합니다. 자세한 내용은 이 가이드의 3단계에 있는 개발 프로젝트 설정을 참고하세요.

이 섹션에서는 앱에서 더욱 안전하게 참조할 수 있도록 API 키를 저장하는 방법을 설명합니다. API 키 보안 권장사항에 관한 자세한 내용은 Google Maps Platform의 API 보안 권장사항 도움말을 참고하세요.

이 작업을 간소화하려면 GitHub 문서 Android용 Secrets Gradle 플러그인을 사용하세요.

플러그인을 설치하여 API 키를 저장하는 방법은 다음과 같습니다.

  1. 루트 수준 build.gradle 파일을 열고 buildscript 아래 dependencies 요소에 다음 코드를 추가합니다.

    Groovy

    buildscript {
      dependencies {
          // ...
          classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
      }
}

    Kotlin

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
    }
}

  2. 앱 수준 build.gradle 파일을 열고 plugins 요소에 다음 코드를 추가합니다.

    Groovy

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. Android 스튜디오를 사용하는 경우 프로젝트를 Gradle과 동기화합니다. 자세한 내용은 Android 문서의 프로젝트를 Gradle과 동기화를 참고하세요.

  4. 프로젝트 수준 디렉터리에서 local.properties를 열고 다음 코드를 추가합니다. YOUR_API_KEY를 직접 생성한 API 키로 변경합니다.

    MAPS_API_KEY=YOUR_API_KEY

  5. AndroidManifest.xml 파일에서 com.google.android.geo.API_KEY로 이동한 후 android:value 속성을 다음과 같이 업데이트합니다.

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${MAPS_API_KEY}" />

다음 예는 샘플 앱의 전체 매니페스트를 보여줍니다.

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme">

            <meta-data
                android:name="com.google.android.geo.API_KEY"
                android:value="${MAPS_API_KEY}" />

            <activity android:name=".MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

앱에 필요한 저작자 표시 포함

앱에서 Consumer SDK를 사용하는 경우 앱의 법적 고지 섹션에 저작자 표시 텍스트와 오픈소스 라이선스를 포함해야 합니다. 저작자 표시는 독립적인 메뉴 항목 또는 정보 메뉴 항목의 일부로 포함하는 것이 가장 좋습니다.

보관 파일이 해제된 AAR 파일의 'third_party_licenses.txt' 파일에서 라이선스 정보를 확인할 수 있습니다.

오픈소스 알림을 포함하는 방법은 https://developers.google.com/android/guides/opensource를 참고하세요.

다음 단계

인증 토큰 가져오기