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

เลือกแพลตฟอร์ม แอนดรอยด์ iOS

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

สิ่งที่ต้องมีก่อนและหมายเหตุ

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

แหล่งอ้างอิง เอกสาร มีอยู่ใน 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.8.2")
}

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

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

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

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

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 ของคุณ

  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