다음에 대해 소비자 SDK를 사용하도록 Google Cloud 콘솔을 설정하고 구성합니다. Android의 경우 다음 단계를 따르세요.
각 단계에 관한 자세한 내용은 다음 섹션을 참고하세요.
개발 프로젝트 설정
Google Cloud 콘솔 개발 프로젝트 및 하나를 설정해야 합니다 자세한 내용은 Fleet Engine 가이드에서 프로젝트를 만듭니다.
소비자 SDK용 개발 프로젝트를 선택할 때 Fleet Engine에 사용하는 것과 동일한 Google Cloud 콘솔 프로젝트 및 API 키입니다.
앱에 소비자 SDK 추가
소비자 SDK는 비공개 Maven 저장소에서 제공됩니다. 저장소 여기에는 SDK의 프로젝트 객체 모델 (.pom) 파일 및 Javadocs가 포함됩니다. 이 소비자 SDK를 앱에 적용하려면 다음 단계를 따르세요.
다음에 설명된 대로 호스트 Maven 저장소에 액세스하도록 환경을 설정합니다. 이 가이드의 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 키를 저장하는 방법은 다음과 같습니다.
루트 수준
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") } }
앱 수준
build.gradle
파일을 열고 다음 코드를plugins
요소Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Android 스튜디오를 사용하는 경우 프로젝트를 Gradle과 동기화합니다. 자세한 내용은 Android 문서에서 프로젝트를 Gradle과 동기화하세요.
프로젝트 수준 디렉터리에서
local.properties
을 열고 다음을 추가합니다. 다음 코드를 실행합니다.YOUR_API_KEY
를 직접 생성한 API 키로 변경합니다.MAPS_API_KEY=YOUR_API_KEY
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를 참고하세요. 오픈소스 고지를 포함해야 합니다