Google Cloud 콘솔 프로젝트 구성

다음에 대해 소비자 SDK를 사용하도록 Google Cloud 콘솔을 설정하고 구성합니다. Android의 경우 다음 단계를 따르세요.

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

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

개발 프로젝트 설정

Google Cloud 콘솔 개발 프로젝트 및 하나를 설정해야 합니다 자세한 내용은 Fleet Engine 가이드에서 프로젝트를 만듭니다.

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

앱에 소비자 SDK 추가

소비자 SDK는 비공개 Maven 저장소에서 제공됩니다. 저장소 여기에는 SDK의 프로젝트 객체 모델 (.pom) 파일 및 Javadocs가 포함됩니다. 이 소비자 SDK를 앱에 적용하려면 다음 단계를 따르세요.

  1. 다음에 설명된 대로 호스트 Maven 저장소에 액세스하도록 환경을 설정합니다. 이 가이드의 2단계입니다.

  2. 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:VERSION_NUMBER"
}

    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 키 추가

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

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

이 작업을 간소화하려면 GitHub 문서인 Secrets Gradle(보안 비밀 Gradle) Android용 Plugin입니다.

플러그인을 설치하여 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>

앱에 필수 저작자 표시 포함

앱에서 소비자 SDK를 사용하는 경우 저작자 표시 텍스트와 앱 법적 고지 섹션의 일부로 오픈소스 라이선스를 구매할 수 있습니다. 가장 좋은 방법은 저작자 표시는 독립적인 메뉴 항목 또는 정보 메뉴 항목을 찾습니다.

라이선스 정보는 'third_party_licenses.txt'에서 확인할 수 있습니다. 파일 보관되지 않은 AAR 파일

자세한 내용은 https://developers.google.com/android/guides/opensource를 참고하세요. 오픈소스 고지를 포함해야 합니다

다음 단계

인증 토큰 받기