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

Maps 3D SDK สำหรับ Android ช่วยให้แอป Android แสดงแผนที่ 3 มิติแบบอินเทอร์แอกทีฟที่สร้างจากภาพ 3 มิติของ Google ได้ โดยมีเครื่องหมาย, ป๊อปโอเวอร์, เส้นประกอบ, รูปหลายเหลี่ยม, โมเดล 3 มิติ glTF, ภาพเคลื่อนไหวเส้นทางกล้อง และการควบคุมสำหรับการโต้ตอบของผู้ใช้และการเคลื่อนไหวของกล้อง

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

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

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

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

  • คุณต้องแสดงแผนที่ 3 มิติแบบสมจริงและโต้ตอบได้ของสถานที่ในชีวิตจริงในแอป Android
  • คุณต้องมีเครื่องหมาย, ป๊อปโอเวอร์, เส้นประกอบ, รูปหลายเหลี่ยม หรือโมเดล 3 มิติ glTF ที่วางอยู่บนแผนที่ 3 มิติในแอป Android
  • คุณต้องใช้ภาพเคลื่อนไหวของกล้องที่กำหนดไว้ล่วงหน้า (บินไปยัง บินวนรอบ) ซึ่งจะนำทางผู้ใช้ระหว่างจุดต่างๆ บนแผนที่ 3 มิติ
  • คุณต้องควบคุมการเคลื่อนไหวของกล้องและตัวควบคุม UI ที่ผู้ใช้สามารถใช้ในแผนที่ 3 มิติในแอป Android

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

  • คุณกำลังสร้างเว็บแอปที่ต้องใช้แผนที่ 3 มิติ โปรดใช้ Maps JavaScript API แทน
  • คุณกำลังสร้างแอป iOS ที่ต้องใช้แผนที่ 3 มิติ โปรดใช้ Maps 3D SDK สำหรับ iOS แทน
  • คุณต้องมีแผนที่ถนนแบบ 2 มิติมาตรฐานที่พร้อมใช้งานจริงในแอป Android (โหมด ROADMAP ใน SDK นี้อยู่ในขั้นทดลอง) โปรดใช้ Maps SDK สำหรับ Android แทน

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

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

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

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

  • ปัญหา: หากไม่ได้ระบุโหมดแผนที่เมื่อโหลดแผนที่ แผนที่จะโหลดไม่สำเร็จ วิธีแก้ไข: ตั้งค่า Map3DMode (SATELLITE, HYBRID หรือ ROADMAP) ใน XML ของเลย์เอาต์ (map3d:mapMode) หรือด้วย setMapMode/Map3DInitConfig เสมอ ดู /maps/documentation/maps-3d/android-sdk/map-modes
  • ปัญหา: ฟังก์ชันรอคลิก (การคลิกแผนที่และเครื่องหมาย) ไม่ทำงานในเธรด UI หลัก ดังนั้นการอัปเดต UI โดยตรงจากเครื่องจัดการจึงไม่สำเร็จ วิธีแก้ไข: เปลี่ยนไปใช้เธรดหลักก่อนอัปเดต UI เช่น ด้วย lifecycleScope.launch(Dispatchers.Main) ดู /maps/documentation/maps-3d/android-sdk/add-a-marker
  • ปัญหา: สถานะแผนที่จะแชร์ในอินสแตนซ์ Map3DView ดังนั้นเครื่องหมาย การวางซ้อน และตำแหน่งกล้องจากมุมมองเก่าจะส่งต่อไปยังมุมมองใหม่ วิธีแก้ไข: เก็บ Map3DView ที่ใช้งานอยู่ไว้เพียงรายการเดียว เรียกใช้ onDestroy() ในอินสแตนซ์เก่า แล้วล้างเครื่องหมาย การวางซ้อน และรีเซ็ตกล้องด้วยตนเองผ่าน GoogleMap3D ดู /maps/documentation/maps-3d/android-sdk/add-a-3d-map
  • ปัญหา: โดยค่าเริ่มต้น การแตะจุดที่น่าสนใจในแผนที่ฐานจะแสดงวิดเจ็ต UI ของ Places ซึ่งต้องใช้ทรัพยากร Dependency ของ Places SDK ด้วย วิธีแก้ไข: เพิ่มทรัพยากร Dependency ของ Places SDK สำหรับ Android และแสดงผล true จาก onMap3DClick ใน OnMap3DClickListener เพื่อระงับวิดเจ็ตเริ่มต้นหากไม่ต้องการใช้ ดู /maps/documentation/maps-3d/android-sdk/points-of-interest

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

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