ตั้งค่า

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

ข้อกำหนดเบื้องต้น

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

• ระดับ API ขั้นต่ำ: Android API ระดับ 24 (Android 7.0) ขึ้นไป แอปของคุณต้องกำหนดเป้าหมาย minSdk เป็น 24 ขึ้นไป
• บริการ Google Play: Maps 3D SDK สำหรับ Android ต้องใช้ บริการ Google Play อุปกรณ์เป้าหมาย (และโปรแกรมจำลองที่มี Google API) ต้องติดตั้งบริการ Google Play

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

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

ขั้นตอนที่ 1

คอนโซล

1. ในคอนโซล Google Cloud ให้คลิก สร้างโปรเจ็กต์ ในหน้าตัวเลือกโปรเจ็กต์เพื่อเริ่มสร้างโปรเจ็กต์ Cloud ใหม่

   ไปที่หน้าตัวเลือกโปรเจ็กต์

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

   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 ใด ให้ลองใช้ Capabilities Explorer หรืออ่านเอกสารประกอบสำหรับ API/SDK ที่ต้องการใช้

วิธีเปิดใช้ API หรือ SDK อย่างน้อย 1 รายการ

คอนโซล

1. ดู API และ SDK ของ Google Maps Platform ที่คุณเปิดใช้ได้โดยไปที่หน้าคลัง API ของ Maps ในคอนโซล Cloud

   ไปที่หน้าคลัง API ของ Maps

2. คลิก API หรือ SDK ที่ต้องการเปิดใช้
   • หากปุ่มระบุว่าเปิดใช้ ให้คลิกปุ่มเพื่อเปิดใช้ API หรือ SDK
   • หากปุ่มระบุว่า จัดการ แสดงว่า API หรือ SDK เปิดใช้อยู่แล้วและคุณ ไม่จำเป็นต้องดำเนินการใดๆ เพิ่มเติม
   • การคลิกปุ่มใดปุ่มหนึ่งจะแสดง แดชบอร์ดสำหรับ API หรือ SDK (คลิกปุ่มปิดใช้ เพื่อนำ API หรือ SDK ออกจากโปรเจ็กต์นี้)

Cloud SDK

คำสั่งต่อไปนี้จะเปิดใช้ API ทั้งหมดของ Maps, Routes และ Places

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 และคำสั่งต่อไปนี้

• gcloud services enable
• gcloud services disable

ใช้คำสั่งนี้เพื่อเปิดใช้ Environment API

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

หมายเหตุ: การเปิดใช้ Places API จะเปิดใช้ Places Library, Maps JavaScript API, Places SDK สำหรับ Android และ Places SDK สำหรับ iOS ด้วย

ขั้นตอนที่ 3

ขั้นตอนนี้จะอธิบายเฉพาะกระบวนการสร้างคีย์ API หากคุณใช้คีย์ API ใน เวอร์ชันที่ใช้งานจริง เราขอแนะนำอย่างยิ่งให้คุณจำกัดคีย์ API ดูข้อมูลเพิ่มเติมได้ในหน้าการใช้คีย์ API ที่เฉพาะเจาะจงกับผลิตภัณฑ์

คีย์ API คือตัวระบุที่ไม่ซ้ำกันซึ่งใช้ในการตรวจสอบสิทธิ์คำขอที่เชื่อมโยงกับโปรเจ็กต์ของคุณเพื่อ วัตถุประสงค์ในการใช้งานและการเรียกเก็บเงิน คุณต้องมีคีย์ API อย่างน้อย 1 รายการที่เชื่อมโยงกับโปรเจ็กต์

วิธีสร้างคีย์ API

คอนโซล

1. ไปที่หน้า Google Maps Platform > ข้อมูลเข้าสู่ระบบ

   ไปที่หน้าข้อมูลเข้าสู่ระบบ

2. ในหน้าข้อมูลเข้าสู่ระบบ ให้คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
   กล่องโต้ตอบสร้างคีย์ API แล้ว จะแสดงคีย์ API ที่สร้างขึ้นใหม่
3. คลิกปิด
   คีย์ 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 โปรดดูหน้า 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 ในการกำหนดค่าโปรเจ็กต์ ให้ตั้งค่า Minimum SDK เป็น API 24 ขึ้นไป

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 = "16.0.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
   }
   

   • เพิ่มการขึ้นต่อกันของบริการ Google Play สำหรับ Maps 3D SDK สำหรับ Android ลงในบล็อก 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
   

   หมายเหตุ: โปรดตรวจสอบว่าคุณได้แทนที่ YOUR_API_KEY_HERE ด้วยคีย์ API ที่คุณ กำหนดค่าไว้เพื่อใช้กับ Maps 3D SDK สำหรับ Android

2. สร้างไฟล์ local.defaults.properties โดยทำดังนี้ - สร้างไฟล์ใหม่ชื่อ local.defaults.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

การเริ่มต้นมุมมองแบบเป็นโปรแกรม (ไม่บังคับ)

หากต้องการเริ่มต้นมุมมองแผนที่แบบเป็นโปรแกรมแทนที่จะใช้เลย์เอาต์ XML ให้ใช้ Map3DInitConfig

import com.google.android.gms.maps3d.Map3DInitConfig
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.model.Map3DMode

// Set configuration options using the factory method
val config = Map3DInitConfig.create(
    mapMode = Map3DMode.HYBRID,
    centerLat = 38.544012,
    centerLng = -107.670428
)

val map3DView = Map3DView(context, config)

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

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