Google Cloud 콘솔 프로젝트 구성

다음을 위한 Driver SDK를 사용하도록 Google Cloud 콘솔 프로젝트 설정 및 구성 Android의 경우 다음 단계를 따르세요.

1. 모바일 앱 프로젝트를 설정합니다.
2. 앱에 드라이버 SDK 추가
3. 앱에 API 키를 추가합니다.
4. 앱에 필수 저작자 표시를 포함합니다.

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

참고: 앱은 minSdkVersion를 타겟팅해야 합니다. 23 이상.

모바일 앱 프로젝트 설정

이 섹션에서는 Driver용으로 모바일 앱 프로젝트를 구성하는 방법을 설명합니다. 사용할 수 있습니다

모바일 앱 프로젝트를 구성하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔 개발 프로젝트와 API 키가 없는 경우 을 사용하려면 모바일 기기를 설정해야 합니다 자세한 내용은 Fleet Engine 프로젝트를 만듭니다.
2. Google Cloud 콘솔에서 동일한 Google Cloud 콘솔 프로젝트를 선택합니다. Fleet Engine에 사용 중인 API 키입니다.
3. API 및 서비스로 이동하여 Android용 Maps SDK.

앱에 드라이버 SDK 추가

Driver SDK는 Google Maven 저장소에서 제공됩니다. 저장소 여기에는 SDK의 프로젝트 객체 모델 (.pom) 파일 및 Javadocs가 포함됩니다.

앱에 Driver SDK를 추가하려면 Driver SDK와 Navigation SDK를 추가합니다. 종속 항목을 Gradle 또는 Maven 구성에 추가해야 합니다.

참고: Driver SDK는 Navigation SDK에 종속됩니다. 종속 항목을 이 예와 같이 명시적으로 정의된 버전의 Navigation SDK를 사용해야 합니다. 그렇지 않으면 예시 코드 블록을 생략하여 프로젝트가 항상 다운로드되도록 설정합니다. Navigation SDK의 최신 버전을 설치해야 합니다. 이 최신 버전의 드라이버 SDK와 Navigation SDK의 결합된 동작은 출시 전에 엄격한 테스트를 거쳤습니다.

다음 예에서 VERSION_NUMBER을 선택한 버전으로 바꾸세요. 설치해야 합니다

Gradle

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

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

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

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

앱에 API 키 추가

앱에 드라이버 SDK를 추가한 후 API 키를 추가합니다. 다음을 사용해야 합니다. 개발 프로젝트를 설정할 때 가져온 프로젝트 API 키입니다. 대상 자세한 내용은 모바일 앱 프로젝트 설정을 참고하세요.

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

중요: API 키를 버전 제어 시스템에 체크인하지 마세요. 대신 루트 디렉터리에 있는 local.properties 파일에 저장합니다. 역할을 합니다 local.properties 파일에 관한 자세한 내용은 다음을 참고하세요. Gradle 속성 파일.

이 작업을 간소화하려면 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과 동기화합니다. 자세한 내용은 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.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_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>

참고: 최상의 내비게이션 환경을 위해 운전자는 다음 권한을 부여해야 합니다. 권한: android.permission.ACCESS_COARSE_LOCATION 및 android.permission.ACCESS_FINE_LOCATION 다음에서 이 두 가지를 모두 요청하세요. 실행할 수 있습니다.

앱에 필수 저작자 표시 포함

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

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

오픈소스 고지 포함에서 오픈소스 고지를 포함해야 합니다

다음 단계

종속 항목 선언