Maps SDK สำหรับการตั้งค่ายูทิลิตีของ Android

หน้านี้อธิบายวิธีตั้งค่าไลบรารีของยูทิลิตี Maps SDK สำหรับ Androidและวิธีเรียกใช้แอปเดโมที่รวมอยู่ในไลบรารี

เกณฑ์เบื้องต้นและหมายเหตุ

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

เอกสารอ้างอิง มีให้บริการใน GitHub

ขั้นตอนที่ 1 ติดตั้งไลบรารีของยูทิลิตี Maps SDK สำหรับ Android

เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle.kts ของแอป

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation("com.google.maps.android:android-maps-utils:3.19.0")
}

ใช้ยูทิลิตีอย่างใดอย่างหนึ่งจากไลบรารี เช่น การจัดกลุ่มมาร์กเกอร์, ฮีตแมป, หรือ ยูทิลิตีอื่นๆ

ขั้นตอนที่ 2 (ไม่บังคับ) ติดตั้งไลบรารีของยูทิลิตี Maps SDK สำหรับ Android KTX

ไลบรารีของยูทิลิตี Maps SDK สำหรับ Android มาพร้อมกับไลบรารีส่วนขยาย Kotlin (KTX) ที่เกี่ยวข้อง ไลบรารีนี้มีฟีเจอร์ภาษา Kotlin เช่น ฟังก์ชันส่วนขยาย อาร์กิวเมนต์ที่มีชื่อ และอาร์กิวเมนต์เริ่มต้น เพื่อให้คุณเขียน Kotlin ที่กระชับและเป็นสำนวน หากไม่ได้พัฒนาใน Kotlin คุณสามารถข้ามขั้นตอนนี้ได้

หากต้องการใช้ไลบรารีนี้ ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle.kts ของแอป นอกเหนือจากทรัพยากร Dependency android-maps-utils

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารีนี้ได้ที่หน้า GitHub ของ Maps KTX

ขั้นตอนที่ 3 ดูซอร์สโค้ดของไลบรารีของยูทิลิตี Maps SDK สำหรับ Android

เนื่องจากไลบรารีของยูทิลิตีเป็นโอเพนซอร์ส คุณจึงดาวน์โหลด android-maps-utils ไลบรารีลงในเครื่องเพื่อปรับแต่ง ดูแอปเดโม หรือหากเพียงต้องการทำความเข้าใจวิธีการทำงาน ของไลบรารี คุณทำได้โดย โคลนที่เก็บ (แนะนำให้ทำ เพื่อรับการอัปเดตอัตโนมัติ) หรือ ดาวน์โหลด ไฟล์ ZIP หากต้องการปรับแต่งไลบรารี คุณควร ฟอร์กที่เก็บ

ที่เก็บประกอบด้วย

• แอปพลิเคชันเดโมในไดเรกทอรี demo
• ไลบรารีของยูทิลิตีในไดเรกทอรี library
• ไฟล์ต่างๆ ที่มีข้อมูลใบอนุญาต ผู้มีส่วนร่วม และข้อมูลอ่านเพิ่มเติม
• การกำหนดค่าบิลด์ Gradle สำหรับใช้กับ Android Studio

เรียกใช้แอปเดโมของยูทิลิตี

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

1. ดาวน์โหลดที่เก็บโดยใช้ตัวเลือกใดตัวเลือกหนึ่งที่กล่าวถึงข้างต้น
2. ใน Android Studio ให้เลือก File -> New -> Import Project
3. เรียกดูและเลือก (ดับเบิลคลิก) ไดเรกทอรี android-maps-utils ที่สร้างขึ้นเมื่อคุณ โคลนไลบรารีของยูทิลิตี ตอนนี้ Android Studio จะสร้างโปรเจ็กต์
4. หากใช้อุปกรณ์ Android แทนอีมูเลเตอร์ ให้ตรวจสอบว่าได้ เปิดใช้โหมดนักพัฒนาแอปแล้ว จากนั้นเชื่อมต่ออุปกรณ์ Android กับคอมพิวเตอร์

5. เพิ่มบรรทัดเดียวลงใน local.properties ซึ่งมีลักษณะดังนี้

   MAPS_API_KEY=YOUR_API_KEY

   โดยที่ YOUR_API_KEY คือคีย์ API ที่คุณได้รับตามที่อธิบายไว้ใน หัวข้อการใช้คีย์ API

6. สร้างและเรียกใช้แอป demo

แอปควรเปิดขึ้นในอุปกรณ์ Android โดยแสดงรายการยูทิลิตีต่างๆ รวมถึงการจัดกลุ่ม PolyUtil ฮีตแมป และอื่นๆ นอกจากนี้ คุณยังดูแอปได้ใน รายการแอป โดยใช้ชื่อว่า Maps Utils Demo