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

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

ข้อกำหนดเบื้องต้นและหมายเหตุ

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

ดูเอกสารประกอบอ้างอิงได้ใน GitHub

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

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

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.8.0'
}

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

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

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

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

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.0.0'
}

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

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

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

ที่เก็บประกอบด้วยข้อมูลต่อไปนี้

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

เรียกใช้แอปสาธิตยูทิลิตี

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

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

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

   MAPS_API_KEY=YOUR_API_KEY

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

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

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