ตั้งค่า

หน้านี้จะอธิบายสิ่งที่คุณต้องทำเพื่อตั้งค่าให้พร้อมสำหรับการเริ่มต้นสร้างแอปด้วย Maps 3D SDK สำหรับ Android กระบวนการตั้งค่าเกี่ยวข้องกับการกำหนดค่าโปรเจ็กต์ Google Cloud และ API เพื่อใช้กับ SDK จากนั้นตั้งค่าโปรเจ็กต์ Android Studio ทำตามขั้นตอนเหล่านี้ให้เสร็จสมบูรณ์ก่อนเพิ่มแผนที่ 3 มิติแรกลงใน แอป

ตั้งค่าโปรเจ็กต์ Google Cloud และคีย์ API

ก่อนที่จะเริ่มสร้างแอปด้วย Maps 3D SDK สำหรับ Android คุณต้องตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google และคีย์ API เพื่อใช้กับ Maps 3D SDK สำหรับ Android โดยทำตามขั้นตอนต่อไปนี้

gcloud projects create "PROJECT"

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"

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

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

หากต้องการเปิดใช้ SDK โปรดดูหน้า Maps 3D SDK สำหรับ Android ในคอนโซล Google Cloud ดูข้อมูลเพิ่มเติมเกี่ยวกับการทำตามขั้นตอนเหล่านี้ได้ที่หัวข้อ เริ่มต้นใช้งาน Google Maps Platform

ตั้งค่าโปรเจ็กต์ Android Studio

ส่วนนี้จะอธิบายวิธีสร้างและกำหนดค่าโปรเจ็กต์ Android Studio เพื่อใช้กับ Maps 3D SDK สำหรับ Android

ส่วนที่ 1: ตั้งค่าโปรเจ็กต์และการกำหนดค่า Gradle

1. สร้างโปรเจ็กต์ Android Studio ใหม่โดยใช้เทมเพลต Empty Views Activity

2. หากใช้ Git สำหรับการควบคุมแหล่งที่มา ให้แก้ไขไฟล์ .gitignore ของโปรเจ็กต์เพื่อป้องกันไม่ให้ระบบคอมมิตไฟล์ข้อมูลลับลงในการควบคุมเวอร์ชัน โดยทำดังนี้

   • เปิดไฟล์ .gitignore ในไดเรกทอรีรากของโปรเจ็กต์
   • เพิ่มบรรทัดต่อไปนี้

   secrets.properties
   

3. อัปเดตไฟล์ build.gradle.kts ระดับโปรเจ็กต์ โดยทำดังนี้

   • เปิดไฟล์ build.gradle.kts ในไดเรกทอรีรากของโปรเจ็กต์
   • เพิ่มปลั๊กอิน Secrets Gradle ลงในบล็อก plugins โดยทำดังนี้

   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
   }
   

4. อัปเดตไฟล์ gradle/libs.versions.toml โดยทำดังนี้

   • เปิดไฟล์ gradle/libs.versions.toml ซึ่งโดยปกติจะอยู่ใน ไดเรกทอรี gradle ภายในไดเรกทอรีรากของโปรเจ็กต์
   • เพิ่มเวอร์ชันสำหรับ SDK และปลั๊กอิน Secrets Gradle ลงในส่วน [versions] โดยทำดังนี้

   # See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
   maps3dSdk = "0.2.0"
   # See https://github.com/google/secrets-gradle-plugin/releases for available releases
   secretsGradlePlugin = "2.0.1"
   

   • เพิ่มไลบรารี SDK ลงในส่วน [library] โดยทำดังนี้

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

   • เพิ่มปลั๊กอิน Secrets Gradle ลงในส่วน [plugins] โดยทำดังนี้

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

5. อัปเดตไฟล์ app/build.gradle.kts ระดับโมดูล โดยทำดังนี้

   • เปิดไฟล์ build.gradle.kts ระดับโมดูล ซึ่งโดยปกติจะอยู่ในไดเรกทอรี app
   • เพิ่มปลั๊กอิน Secrets Gradle ลงในบล็อก plugins ที่ด้านบนของไฟล์ โดยทำดังนี้

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

   • เพิ่ม SDK ลงในบล็อก dependencies โดยทำดังนี้

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

   • เพิ่มการกำหนดค่าข้อมูลลับที่ส่วนท้ายของไฟล์ นอกบล็อก android และ dependencies โดยทำดังนี้

   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 ลงในโปรเจ็กต์

1. สร้างไฟล์ secrets.properties โดยทำดังนี้

   • สร้างไฟล์ใหม่ชื่อ secrets.properties ในไดเรกทอรีรากของโมดูลแอป (โดยปกติคือไดเรกทอรี app)
   • เพิ่มคีย์ API ลงในไฟล์ โดยทำดังนี้

   MAPS3D_API_KEY=YOUR_API_KEY_HERE
   

2. สร้างไฟล์ local.defaults.properties โดยทำดังนี้ - สร้างไฟล์ใหม่ชื่อ secrets.properties ในไดเรกทอรีรากของโมดูลแอป - เพิ่มคีย์ API เริ่มต้นหรือคีย์ API ที่เป็นตัวยึดตำแหน่งลงในไฟล์ คุณสามารถเช็กอินไฟล์นี้ลงในการควบคุมเวอร์ชันได้

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

ส่วนที่ 3: อัปเดตไฟล์ AndroidManifest.xml

1. เปิดไฟล์ app/src/main/AndroidManifest.xml

2. เพิ่มองค์ประกอบ <meta-data> ต่อไปนี้ภายในแท็ก <application> ก่อนแท็ก <activity> เพื่อประกาศคีย์ 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

ขั้นตอนถัดไป

เมื่อตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google, คีย์ API และโปรเจ็กต์ Android Studio เพื่อใช้กับ Maps 3D SDK สำหรับ Android แล้ว คุณก็สามารถเพิ่มแผนที่ 3 มิติลงในแอปได้