หน้านี้จะอธิบายวิธีตั้งค่า 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 (ไม่บังคับ) ติดตั้ง Maps SDK สำหรับไลบรารี KTX ยูทิลิตีของ Android
ไลบรารียูทิลิตีของ Maps SDK สำหรับ Android มาพร้อมกับส่วนขยาย Kotlin ที่สอดคล้องกัน (KTX) ไลบรารีนี้มีฟีเจอร์ภาษา 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.1.1' }
ดูหน้า Maps KTX GitHub เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารีนี้
ขั้นตอนที่ 3 ดูซอร์สโค้ดของไลบรารียูทิลิตีของ Maps SDK สำหรับ Android
เนื่องจากไลบรารียูทิลิตีเป็นโอเพนซอร์ส คุณสามารถดาวน์โหลด android-maps-utils ไลบรารีไปยังเครื่องของคุณเพื่อปรับแต่ง ดูแอปเดโม หรือหากคุณต้องการเพียงแค่ทำความเข้าใจวิธี ที่ไลบรารีใช้งานได้ คุณสามารถทำได้โดย การโคลนที่เก็บ (แนะนำ เพื่อรับการอัปเดตอัตโนมัติ) หรือ กำลังดาวน์โหลด ไฟล์ ZIP หากคุณต้องการปรับแต่งไลบรารี คุณควร แยกที่เก็บ
ที่เก็บประกอบด้วยรายการต่อไปนี้
- แอปพลิเคชันเดโมในไดเรกทอรี
demo
- ไลบรารีของยูทิลิตีในไดเรกทอรี
library
- ไฟล์ต่างๆ ที่มีใบอนุญาต ผู้ร่วมให้ข้อมูล และข้อมูล Readme
- การกำหนดค่าบิลด์ Gradle สำหรับใช้กับ Android Studio
เรียกใช้แอปการสาธิตยูทิลิตี
ที่เก็บ GitHub สำหรับไลบรารียูทิลิตีจะจัดส่งพร้อมกับแอปเดโมที่มีตัวอย่าง ของยูทิลิตีแต่ละแบบ ทำตามขั้นตอนต่อไปนี้เพื่อเรียกใช้แอปเดโม อุปกรณ์ Android ของคุณ
- ดาวน์โหลดที่เก็บโดยใช้ตัวเลือกใดตัวเลือกหนึ่งที่กล่าวถึงข้างต้น
- ใน Android Studio ให้เลือกไฟล์ -> ใหม่ -> นำเข้าโปรเจ็กต์
- เรียกดูและเลือก (ดับเบิลคลิก) ไดเรกทอรี android-maps-utils ที่สร้างขึ้นเมื่อคุณ โคลนไลบรารียูทิลิตีแล้ว ตอนนี้ Android Studio จะสร้างโปรเจ็กต์แล้ว
- หากคุณใช้อุปกรณ์ Android แทนโปรแกรมจำลอง ให้ทำดังนี้ เปิดใช้โหมดนักพัฒนาซอฟต์แวร์ จากนั้นแนบอุปกรณ์ Android เข้ากับคอมพิวเตอร์
เพิ่มบรรทัดเดียวลงใน
local.properties
ซึ่งมีลักษณะดังนี้:MAPS_API_KEY=YOUR_API_KEY
โดยที่ YOUR_API_KEY คือคีย์ API ที่คุณได้รับตามที่อธิบายไว้ใน การใช้คีย์ API
- สร้างและเรียกใช้แอปสาธิต
แอปควรเปิดในอุปกรณ์ Android โดยแสดงรายการยูทิลิตี ซึ่งรวมถึงการจัดกลุ่ม, poyutil, แผนที่ความหนาแน่น และอื่นๆ นอกจากนี้ คุณยังค้นหาแอปได้ใน รายชื่อแอปภายใต้ชื่อ Maps Utils Demo