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: การตั้งค่า
- บริการที่ต้องเปิดใช้:
mapsandroid.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- เริ่มต้นใช้งาน: ตั้งค่า Maps 3D SDK สำหรับ Android
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Maps 3D SDK สำหรับ Android
- ราคา: การใช้งานและการเรียกเก็บเงินของ Maps 3D SDK สำหรับ Android
- นโยบาย: นโยบาย Maps 3D SDK สำหรับ Android
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Maps 3D SDK สำหรับ Android
แพ็กเกจ Maps 3D SDK สำหรับ Android อย่างเป็นทางการ
- maven:
com.google.android.gms:play-services-maps3d
Maps 3D SDK สำหรับ Android: สินค้าที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Places SDK สำหรับ Android
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
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- เพิ่มแผนที่ 3 มิติแบบสมจริงและโต้ตอบได้ลงในหน้าเว็บ
- เพิ่มเครื่องหมายลงในแผนที่ 3 มิติที่สมจริง
- ปรับแต่งเครื่องหมายบนแผนที่ 3 มิติแบบสมจริง
- เพิ่มโมเดล 3 มิติลงในแผนที่ 3 มิติแบบสมจริง
- เพิ่มเส้นประกอบ 3 มิติลงในแผนที่ 3 มิติแบบสมจริง
- เพิ่มรูปหลายเหลี่ยม 3 มิติลงในแผนที่ 3 มิติแบบสมจริง
- ตอบสนองต่อการโต้ตอบและเหตุการณ์ของผู้ใช้ในแผนที่ 3 มิติแบบสมจริง
- ปรับแต่งการควบคุมที่ปรากฏในแผนที่ 3 มิติแบบสมจริง
- ควบคุมเส้นทางกล้องและภาพเคลื่อนไหวในแผนที่ 3 มิติที่สมจริง
- ควบคุมข้อจำกัดของกล้องในแผนที่ 3 มิติแบบสมจริง