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

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

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

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

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

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

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

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

  • คุณต้องมีแผนที่ 3 มิติในแอป Android โปรดใช้ Maps 3D SDK สำหรับ Android แทน
  • คุณต้องมีแผนที่ 3 มิติในหน้าเว็บ โปรดใช้ Maps JavaScript API แทน
  • คุณต้องมีแผนที่ 2 มิติมาตรฐานในแอป iOS ให้ใช้ Maps SDK สำหรับ iOS แทน

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

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

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

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

  • ปัญหา: หากไม่ได้ตั้งค่าโหมดแผนที่เมื่อโหลดแผนที่ แผนที่จะโหลดไม่สำเร็จ วิธีแก้ไข: ส่งโหมดทุกครั้งเมื่อสร้าง Map เช่น Map(mode: .hybrid) ดู /maps/documentation/maps-3d/ios-sdk/map-modes
  • ปัญหา: การตั้งค่าคีย์ API ทั้งในจุดแรกเข้าของแอปและในมุมมองแผนที่แต่ละรายการทำให้เกิดข้อผิดพลาดในคอนโซล วิธีแก้ไข: ตั้งค่า Map.apiKey ในที่เดียวเท่านั้น ซึ่งก็คือจุดแรกเข้าของแอปหรือมุมมองแผนที่แต่ละรายการ ดู /maps/documentation/maps-3d/ios-sdk/setup
  • ปัญหา: ระบบจะไม่สนใจ Camera altitudeMode นอกภาพเคลื่อนไหวของกล้อง โดยจะใช้กับ flyCameraTo และ flyCameraAround เท่านั้น วิธีแก้ไข: ใช้ flyCameraTo หรือ flyCameraAround เมื่อคุณใช้ Camera altitudeMode ดู /maps/documentation/maps-3d/ios-sdk/custom-camera-paths
  • ปัญหา: ใน GoogleMaps3DKit วิดเจ็ต UI ของ Places จะแสดงโดยค่าเริ่มต้นเมื่อผู้ใช้แตะจุดที่น่าสนใจ วิธีแก้ไข: ใช้ placeInformationEnabled(false) หรือแสดงผล .none จาก onPlaceTap(_:) เพื่อระงับวิดเจ็ต ดู /maps/documentation/maps-3d/ios-sdk/points-of-interest

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

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