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

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

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

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

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

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

  • คุณต้องการแผนที่ Google แบบอินเทอร์แอกทีฟที่มีการจัดการท่าทางสัมผัสภายในแอป iOS แบบเนทีฟ
  • คุณต้องเพิ่มเครื่องหมาย, เส้นประกอบ, ภาพซ้อนทับบนพื้น หรือหน้าต่างข้อมูลลงในแผนที่ในแอป iOS
  • คุณต้องแสดงภาพพาโนรามาใน Street View ภายในแอป iOS
  • คุณต้องแปลงพิกัดเป็นที่อยู่โดยใช้การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับจากแอป iOS ที่แสดงแผนที่

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

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

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

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

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

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

  • ปัญหา: SDK ไม่รองรับไลบรารีที่ผสานรวมได้ การเปิดใช้ Build Mergeable Library ใน Xcode จะทำให้ Linker ไม่ทำงานในบิลด์ที่เผยแพร่ วิธีแก้ไข: ตั้งค่า Build Mergeable Library เป็น "ไม่" (ค่าเริ่มต้น) ดู /maps/documentation/ios-sdk/config
  • ปัญหา: หากไม่มีรายการ LSApplicationQueriesSchemes การแตะโลโก้ Google บนแผนที่จะบันทึกความล้มเหลวของ -canOpenURL สำหรับ comgooglemaps:// และ googlechromes:// การแก้ไข: เพิ่ม googlechromes และ comgooglemaps ลงใน LSApplicationQueriesSchemes ใน Info.plist ดู /maps/documentation/ios-sdk/config
  • ปัญหา: การใช้ SDK ภายในส่วนขยายแอป iOS (เช่น แป้นพิมพ์ที่กำหนดเอง) อาจไม่ทำงานเนื่องจากข้อจำกัดด้านหน่วยความจำที่เข้มงวด วิธีแก้ไข: ใช้ SDK ในแอปหลัก ไม่ใช่ในส่วนขยายแอป ดู /maps/documentation/ios-sdk/overview
  • ปัญหา: SDK ไม่ได้รับการเพิ่มประสิทธิภาพสำหรับหน้าต่างหลายหน้าต่างหรืออินสแตนซ์ที่ทำงานพร้อมกันของ iPadOS 13 ขึ้นไป และอาจแสดงลักษณะการทำงานที่ไม่ได้กำหนดไว้ วิธีแก้ไข: ทดสอบสถานการณ์การใช้งาน iPad แบบหลายหน้าต่างอย่างรอบคอบ หรือหลีกเลี่ยงการใช้อินสแตนซ์แผนที่หลายรายการพร้อมกัน ดู /maps/documentation/ios-sdk/overview

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

  • โปรแกรมแสดงผล OpenGL และ setMetalRendererEnabled: เลิกใช้งานตั้งแต่วันที่ 19 พฤษภาคม 2025 สิ่งที่ใช้แทน: Metal Renderer (ค่าเริ่มต้นตั้งแต่ v8.0.0) ให้นำ setMetalRendererEnabled ออก อาการ: เลิกใช้งานใน v9.0.0 (28-05-2024) และนำออกใน v10.0.0 โดย GMSServices จะไม่แสดง setMetalRendererEnabled: อีกต่อไป
  • โมดูล GoogleMapsM4B: เลิกใช้งานตั้งแต่วันที่ 19 พ.ค. 2025 การแทนที่: นำพ็อดหรือเฟรมเวิร์ก GoogleMapsM4B ออก เนื่องจากเกี่ยวข้องกับแพ็กเกจการเรียกเก็บเงินที่ล้าสมัย อาการ: เลิกใช้งานเมื่อวันที่ 20-02-2024 โดยนำออกจากแพ็กเกจ Swift ในเวอร์ชัน 9.0.0 และนำออกจาก SDK ในเวอร์ชัน 10.0.0
  • การเผยแพร่ CocoaPods: เลิกใช้งานตั้งแต่วันที่ 06-08-2026 สิ่งที่ใช้แทน: Swift Package Manager อาการ: โหมดการบำรุงรักษาตั้งแต่ 2025-08-18 เลิกใช้งานตั้งแต่เวอร์ชัน 11.0.0 ดูคำแนะนำในการย้ายข้อมูล
  • การติดตั้ง Carthage: เลิกใช้งานตั้งแต่วันที่ 27-06-2022 สิ่งที่ใช้แทน: Swift Package Manager อาการ: Carthage ไม่รองรับไลบรารีที่กำหนดเป้าหมายเป็น iOS 13 ขึ้นไป เวอร์ชันล่าสุดที่ใช้ได้ผ่าน Carthage คือ 6.2.1 ดูคำแนะนำในการย้ายข้อมูล

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

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

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

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

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

Maps SDK สำหรับ iOS: การเข้ารหัสพิกัดภูมิศาสตร์

Maps SDK สำหรับ iOS: Maps

Maps SDK สำหรับ iOS: คำอธิบายประกอบของ Maps

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

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