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

เลือกแพลตฟอร์ม: Android iOS

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

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

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

เอกสารประกอบอ้างอิงมีอยู่ใน GitHub

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

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

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:3.4.0'

}

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

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

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

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

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.4.0'
}

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

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

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

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

  • แอปพลิเคชันสาธิตในไดเรกทอรี demo
  • ไลบรารีของยูทิลิตีในไดเรกทอรี library
  • ไลบรารีของยูทิลิตีสําหรับ Maps SDK สําหรับ v3 เบต้าในไดเรกทอรี library-v3
  • ไฟล์ต่างๆ ที่มีข้อมูลใบอนุญาต ผู้ร่วมให้ข้อมูล และข้อมูล meme
  • การกําหนดค่า 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 ซึ่งแสดงรายการยูทิลิตี ได้แก่ คลัสเตอร์ Poyutil ฮีตแมป และอื่นๆ คุณยังค้นหาแอปในรายการแอปภายใต้ชื่อการสาธิต Maps Utils ได้อีกด้วย