ตั้งค่า

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

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

ก่อนที่จะเริ่มสร้างด้วย Maps 3D SDK สำหรับ Android คุณต้องตั้งค่าโปรเจ็กต์ Google Cloud และคีย์ 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 ใหม่โดยใช้เทมเพลตกิจกรรมที่มีมุมมองว่าง

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

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

   secrets.properties
   

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

   • เปิดไฟล์ build.gradle.kts ในไดเรกทอรีรากของโปรเจ็กต์
   • ในบล็อก plugins ให้เพิ่มปลั๊กอินข้อมูลลับ 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
   }
   

4. อัปเดตไฟล์ 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" }
   

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
   }
   

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

1. วิธีสร้างไฟล์ 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.
   

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

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

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

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

2. ภายในแท็ก <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

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

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