이 페이지는 Cloud Translation API를 통해 번역되었습니다.

설정

이 페이지에서는 Android용 Maps 3D SDK로 빌드를 시작하기 위해 설정해야 하는 사항을 설명합니다. 설정 프로세스에는 SDK와 함께 사용할 Google Cloud 프로젝트 및 API를 구성한 다음 Android Studio 프로젝트를 설정하는 작업이 포함됩니다. 앱에 첫 번째 3D 지도를 추가하기 전에 다음 단계를 완료하세요.

Google Cloud 프로젝트 및 API 키 설정

Android용 Maps 3D SDK로 빌드를 시작하려면 다음 단계를 완료하여 Android용 Maps 3D SDK와 함께 사용할 Google Cloud 프로젝트와 API 키를 설정해야 합니다.

1단계

콘솔

Google Cloud 콘솔의 프로젝트 선택기 페이지에서 프로젝트 만들기를 클릭하여 새 Cloud 프로젝트를 만듭니다.

프로젝트 선택기 페이지로 이동
Cloud 프로젝트에 결제가 사용 설정되어 있어야 하므로 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Google Cloud에서는 무료 체험판을 제공합니다. 무료 체험판은 90일 후 또는 계정에서 300달러에 해당하는 누적 비용이 발생한 시점 중 더 빠른 시점에 만료됩니다. 취소는 언제든지 가능합니다. 자세한 내용은 결제 계정 크레딧 및 결제를 참고하세요.

Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

gcloud projects create

2단계

Google Maps Platform을 사용하려면 프로젝트에 사용할 API 또는 SDK를 사용 설정해야 합니다.

일부 통합의 경우 여러 API/SDK를 사용 설정해야 합니다. 어느 API 또는 SDK를 사용 설정해야 할지 모르는 경우 API 선택도구를 사용해 보거나 사용할 API/SDK 문서를 참고하세요.

하나 이상의 API 또는 SDK를 사용 설정하려면 다음 단계를 따르세요.

콘솔

Cloud 콘솔의 지도 API 라이브러리 페이지로 이동하여 사용 설정할 수 있는 Google Maps Platform API 및 SDK를 확인하세요.

지도 API 라이브러리 페이지로 이동
사용 설정할 API 또는 SDK를 클릭합니다.
- 버튼이 사용 설정으로 표시되면 버튼을 클릭하여 API 또는 SDK를 사용 설정합니다.
- 버튼이 관리로 표시되면 API 또는 SDK가 이미 사용 설정되었으므로 아무 조치도 취할 필요가 없습니다.
- 두 버튼 중 하나를 클릭하면 API 또는 SDK의 대시보드가 표시됩니다. (이 프로젝트에서 API 또는 SDK를 삭제하려면 사용 중지 버튼을 클릭하세요.)

Cloud SDK

다음 명령어는 지도, 경로, 장소 API를 모두 사용 설정합니다.

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

다음 명령어를 사용하여 환경 API를 사용 설정합니다.

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

3단계

이 단계에서는 API 키만 만듭니다. 프로덕션에서 API 키를 사용하는 경우 API 키를 제한하는 것이 좋습니다. 자세한 내용은 제품별 API 키 사용 페이지를 참고하세요.

API 키는 사용 및 결제 목적으로 프로젝트와 관련된 요청을 인증하는 고유 식별자입니다. 프로젝트에 연결된 API 키가 하나 이상 있어야 합니다.

API 키를 만들려면 다음 단계를 따르세요.

콘솔

Google Maps Platform > 사용자 인증 정보 페이지로 이동합니다.

사용자 인증 정보 페이지로 이동하기
사용자 인증 정보 페이지에서 사용자 인증 정보 만들기 > API 키를 클릭합니다.
API 키 생성 완료 대화상자에 새로 만든 API 키가 표시됩니다.
닫기를 클릭합니다.
새 API 키는 사용자 인증 정보 페이지의 API 키 아래 나열됩니다.
(프로덕션에 사용하기 전에 API 키를 제한하세요.)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

gcloud services api-keys create

SDK를 사용 설정하려면 Google Cloud 콘솔의 Android용 Maps 3D SDK 페이지를 참고하세요. 이 단계를 완료하는 방법에 대한 자세한 내용은 Google Maps Platform 시작하기를 참고하세요.

Android 스튜디오 프로젝트 설정

이 섹션에서는 Android용 Maps 3D SDK와 함께 사용할 Android 스튜디오 프로젝트를 만들고 구성하는 방법을 설명합니다.

1부: 프로젝트 및 Gradle 구성 설정

Empty Views Activity 템플릿을 사용하여 새 Android 스튜디오 프로젝트를 만듭니다.
소스 제어에 Git를 사용하는 경우 버전 제어에 보안 비밀 파일이 커밋되지 않도록 프로젝트 .gitignore 파일을 수정합니다.
- 프로젝트의 루트 디렉터리에서 .gitignore 파일을 엽니다.
- 다음 줄을 추가합니다.
```
secrets.properties
```
프로젝트 수준 build.gradle.kts 파일을 업데이트합니다.
- 프로젝트의 루트 디렉터리에서 build.gradle.kts 파일을 엽니다.
- plugins 블록에 Secrets Gradle 플러그인을 추가합니다.
```
plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}
```

gradle/libs.versions.toml 파일을 업데이트합니다. - gradle/libs.versions.toml 파일을 엽니다. 일반적으로 프로젝트 루트 디렉터리 내의 gradle 디렉터리에 있습니다. - 버전 섹션에서 SDK 및 Secrets Gradle 플러그인의 버전을 추가합니다.

maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
secretsGradlePlugin = "2.0.1"

-   In the library section, add the SDK library:

play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }

-   In the plugin section, add the Secrets Gradle plugin:

secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

모듈 수준 app/build.gradle.kts 파일을 업데이트합니다. - 일반적으로 app 디렉터리 내에 있는 모듈 수준 build.gradle.kts 파일을 엽니다. - 파일 상단에서 Secrets Gradle 플러그인을 plugins 블록에 추가합니다.

plugins {
  alias(libs.plugins.android.application)
  alias(libs.plugins.kotlin.android)
  alias(libs.plugins.secrets.gradle.plugin) // Add this line
}

-   In the `dependencies` block, add the SDK:

dependencies {
  // ... other dependencies
  implementation(libs.play.services.maps3d) // Add this line
}

-   At the end of the file, outside of the `android` and `dependencies`
    blocks, add the secrets configuration:

secrets {
  // Optionally specify a different filename containing your secrets.
  // The plugin defaults to "local.properties"
  propertiesFileName = "secrets.properties"

  // A properties file containing default secret values. This file can be
  // checked in version control.
  defaultPropertiesFileName = "local.defaults.properties"
}

2부: 프로젝트에 API 키 추가

secrets.properties 파일을 만듭니다.
- 앱 모듈 루트 디렉터리 (일반적으로 app 디렉터리)에서 secrets.properties이라는 새 파일을 만듭니다.
- 파일에 API 키를 추가합니다.
```
MAPS3D_API_KEY=YOUR_API_KEY_HERE
``` Note: Make sure you
    replace `YOUR_API_KEY_HERE` with the API key that you configured for use
with the Maps 3D SDK for Android.
```
local.defaults.properties 파일을 만듭니다. - 앱 모듈 루트 디렉터리에서 secrets.properties이라는 새 파일을 만듭니다. - 파일에 기본 또는 자리표시자 API 키를 추가합니다. 이 파일은 버전 관리 시스템에 체크인할 수 있습니다.
```
MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
```

3부: `AndroidManifest.xml` 파일 업데이트

app/src/main/AndroidManifest.xml 파일을 엽니다.
<application> 태그 안의 <activity> 태그 앞에 다음 <meta-data> 요소를 추가하여 API 키를 선언합니다.
```
<application
  ...>

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

  <activity
      ...>
  </activity>
</application>
```
빌드 프로세스 중에 Secrets Gradle 플러그인이 ${MAPS3D_API_KEY} 자리표시자를 secrets.properties 파일의 키로 바꿉니다.

다음 단계

이제 Android용 Maps 3D SDK와 함께 사용할 Google Cloud 프로젝트, API 키, Android 스튜디오 프로젝트가 설정되었으므로 앱에 3D 지도를 추가할 수 있습니다.

설정 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Google Cloud 프로젝트 및 API 키 설정

1단계

콘솔

Cloud SDK

2단계

콘솔

Cloud SDK

3단계

콘솔

Cloud SDK

Android 스튜디오 프로젝트 설정

1부: 프로젝트 및 Gradle 구성 설정

2부: 프로젝트에 API 키 추가

3부: AndroidManifest.xml 파일 업데이트

다음 단계

설정

3부: `AndroidManifest.xml` 파일 업데이트