ข้อมูลอ้างอิงฉบับย่อของ Maps SDK สำหรับ Android

Maps SDK สำหรับ Android จะเพิ่มข้อมูล Google Maps, การแสดงแผนที่ และการตอบสนองต่อท่าทางสัมผัสบนแผนที่ลงในแอป Android รวมถึงแอป Wear OS คุณสามารถเพิ่มเครื่องหมาย รูปหลายเหลี่ยม และการวางซ้อนเพื่อแสดงข้อมูลเกี่ยวกับตำแหน่งบนแผนที่และรองรับการโต้ตอบของผู้ใช้โดยใช้ Kotlin หรือ Java

Maps SDK สำหรับ Android: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Maps SDK สำหรับ Android
  • หรือที่รู้จักกันในชื่อ: Google Maps Android API
  • หมวดหมู่: Maps
  • แพลตฟอร์ม: Android
  • ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Maps SDK สำหรับ Android
  • ภูมิภาคที่พร้อมให้บริการ: ทั่วโลก ดูหน้าความครอบคลุมของ Google Maps Platform โดยลิงก์หน้าการใช้งานและการเรียกเก็บเงินจะแยกรายการราคาทั่วโลกและราคาในอินเดียออกจากกัน (รายละเอียดความครอบคลุม)

Maps SDK สำหรับ Android: กรณีที่ควรใช้

ใช้ Maps SDK สำหรับ Android ในกรณีต่อไปนี้

  • คุณต้องการแผนที่ Google แบบ 2 มิติที่มีการโต้ตอบในแอป Android หรือแอป Wear OS แบบเนทีฟ
  • คุณต้องเพิ่มเครื่องหมาย, หน้าต่างข้อมูล, เส้นประกอบ, รูปหลายเหลี่ยม, ภาพซ้อนทับบนพื้น หรือภาพซ้อนทับแบบเรียงต่อกันลงในแผนที่ในแอป Android
  • คุณต้องมีพาโนรามาใน Street View, แผนที่โหมด Lite (บิตแมป) หรือการจัดรูปแบบแผนที่ในระบบคลาวด์ที่มีรหัสแผนที่ในแอป Android
  • คุณสร้างแผนที่ Android ใน Kotlin หรือ Java รวมถึง Jetpack Compose ผ่านไลบรารี Maps Compose

อย่าใช้ Maps SDK สำหรับ Android ในกรณีต่อไปนี้

  • คุณต้องใช้การนำทางแบบเลี้ยวต่อเลี้ยวในแอปแผนที่ Android ให้ใช้ Navigation SDK สำหรับ Android แทน
  • คุณต้องการแผนที่ 3 มิติที่สมจริง โมเดล 3 มิติ หรือภาพเคลื่อนไหวเส้นทางกล้องในแอป Android ให้ใช้ Maps 3D SDK สำหรับ Android แทน
  • คุณต้องมีแผนที่ในแอป iOS แบบเนทีฟ โปรดใช้ Maps SDK สำหรับ iOS แทน

Maps SDK สำหรับ Android: การตั้งค่า

แพ็กเกจ Maps SDK สำหรับ Android อย่างเป็นทางการ

  • maven: com.google.android.gms:play-services-maps

Maps SDK สำหรับ Android: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: ตั้งแต่ SDK v20.0.0 เป็นต้นมา ไฟล์ Manifest ของ SDK จะไม่มีไลบรารี org.apache.http.legacy อีกต่อไป แอปที่โหลดโปรแกรมแสดงผลแผนที่เดิมอาจขัดข้องเมื่อใช้ java.lang.NoClassDefFoundError วิธีแก้ไข: เพิ่ม ไว้ในแท็ก ของ AndroidManifest.xml ของแอป อุปกรณ์ที่ใช้บริการ Google Play เวอร์ชัน 25.50.34 ขึ้นไปจะไม่ได้รับผลกระทบ ดู /maps/documentation/android-sdk/release-notes
  • ปัญหา: Advanced Marker ต้องใช้โปรแกรมแสดงผลแผนที่ที่อัปเกรดแล้ว หากคุณเพิ่มลงในแอปที่มีอยู่โดยไม่สร้างแอปใหม่ แอปจะยังคงใช้โปรแกรมแสดงผลเดิมได้ วิธีแก้ไข: สร้างแอปใหม่ด้วย SDK 18.2.0 ขึ้นไปเพื่อให้โปรแกรมแสดงผลที่อัปเกรดเป็นค่าเริ่มต้น ดู /maps/documentation/android-sdk/advanced-markers/start
  • ปัญหา: อุปกรณ์ที่ไม่เป็นไปตามข้อกำหนดของโปรแกรมแสดงผล (Android 5.0/API 21 ขึ้นไป, บริการ Google Play 21.39.14 ขึ้นไป, เปิดใช้ Play Store) จะกลับไปใช้โปรแกรมแสดงผลเดิม ดังนั้นฟีเจอร์ที่ต้องใช้โปรแกรมแสดงผลใหม่ เช่น การจัดรูปแบบแผนที่ในระบบคลาวด์ จะใช้งานไม่ได้ในอุปกรณ์ดังกล่าว วิธีแก้ไข: เรียกใช้ MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) และตรวจสอบค่า MapsInitializer.Renderer ที่ส่งไปยัง OnMapsSdkInitializedCallback.onMapsSdkInitialized() หรือตรวจสอบ GoogleMap.getMapCapabilities() หากอุปกรณ์ใช้ LEGACY อย่าใช้การจัดรูปแบบแผนที่ในระบบคลาวด์หรือเครื่องหมายขั้นสูง ดู /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback
  • ปัญหา: SDK ต้องใช้บริการ Google Play ในอุปกรณ์ที่แอปทำงาน วิธีแก้ไข: คุณสามารถเรียกใช้การตรวจสอบความพร้อมใช้งานของบริการ Google Play จากแอปได้ ดูข้อมูลเพิ่มเติมที่ /maps/documentation/android-sdk/config

Maps SDK สำหรับ Android: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว

  • Legacy map renderer: เลิกใช้งานตั้งแต่วันที่ 4 มีนาคม 2024 การแทนที่: เครื่องมือแสดงผลแผนที่ที่อัปเกรด (ล่าสุด) ซึ่งเป็นค่าเริ่มต้นตั้งแต่ SDK 18.2.0 อาการ: การจัดรูปแบบแผนที่ในระบบคลาวด์, การปรับแต่งเส้นประกอบขั้นสูง และเครื่องหมายขั้นสูงไม่พร้อมใช้งานในโปรแกรมแสดงผลเดิม ดูคำแนะนำในการย้ายข้อมูล

สิ่งที่คุณทำได้ด้วย Maps SDK สำหรับ Android

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ

Maps SDK สำหรับ Android: การจัดรูปแบบตามข้อมูลสำหรับขอบเขต

Maps SDK สำหรับ Android: การจัดรูปแบบตามข้อมูลสำหรับชุดข้อมูล

Maps SDK สำหรับ Android: ชุดข้อมูล

Maps SDK สำหรับ Android: Maps

Maps SDK สำหรับ Android: คำอธิบายประกอบแผนที่

Maps SDK สำหรับ Android: การจัดสไตล์แผนที่

Maps SDK สำหรับ Android: Street View