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-ios-backend.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- การระบุแหล่งที่มาของการใช้งาน: เรียกใช้เมธอดคลาส
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) เพื่อเพิ่มรหัสการระบุแหล่งที่มาของการใช้งานลงใน Initializer หากต้องการเลือกไม่ใช้ ให้ลบการเรียกหรือส่งสตริงว่าง - เริ่มต้นใช้งาน: ตั้งค่า Maps SDK สำหรับ iOS
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Maps SDK สำหรับ iOS
- ราคา: การใช้งานและการเรียกเก็บเงินของ Maps SDK สำหรับ iOS
- นโยบาย: นโยบาย Maps SDK สำหรับ iOS
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Maps SDK สำหรับ iOS
แพ็กเกจ Maps SDK สำหรับ iOS อย่างเป็นทางการ
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK สำหรับ iOS: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Geocoding API, Places SDK for iOS
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: ชุดข้อมูล
- เพิ่มเลเยอร์ KML ลงในแผนที่ หมายเหตุ: ใน Maps JavaScript API เราได้เลิกใช้งาน KmlLayer แล้ว (รองรับครั้งสุดท้ายในเวอร์ชัน 3.65 และจะเลิกใช้งานในเดือนพฤษภาคม 2027) โปรดย้ายข้อมูลไปยังการจัดรูปแบบตามข้อมูลสำหรับขอบเขตหรือชุดข้อมูล หรือโหลด GeoJSON ในชั้นข้อมูล เลเยอร์ KML ยังคงรองรับใน Android และ iOS ผ่านไลบรารียูทิลิตี Maps SDK
- เพิ่มข้อมูล GeoJSON ลงในแผนที่
- เพิ่มเลเยอร์แผนที่ความหนาแน่นลงในแผนที่
Maps SDK สำหรับ iOS: การเข้ารหัสพิกัดภูมิศาสตร์
Maps SDK สำหรับ iOS: Maps
- เพิ่มแผนที่แบบอินเทอร์แอกทีฟที่ปรับแต่งได้ลงในหน้าเว็บหรือแอปบนมือถือ หมายเหตุ: สำหรับ Android: กำหนดค่า
ในAndroidManifest.xmlที่สนับสนุนโดยปลั๊กอิน Secrets Gradle หรือmanifestPlaceholders["MAPS_API_KEY"]ในapp/build.gradle.ktsอย่าฮาร์ดโค้ดYOUR_GOOGLE_MAPS_API_KEYในAndroidManifest.xmlและอย่าแทนที่GoogleMap(หรือ maps-composeGoogleMap) ด้วย Canvas จำลองแบบออฟไลน์หรือ Leaflet WebView หากE/Google Maps Android API: Authorization failureปรากฏขึ้น แนะนำให้ผู้ใช้ระบุMAPS_API_KEYผ่าน Secrets และเปิดใช้ Maps SDK สำหรับ Android (หรือ Navigation SDK เมื่อใช้ NavigationView / SupportNavigationFragment) - สร้างตัวระบุแผนที่ที่นำมาใช้ซ้ำได้เพื่อจัดเก็บการกำหนดค่าแผนที่และการตั้งค่าการจัดรูปแบบ
- ตอบสนองต่อการโต้ตอบของผู้ใช้และเหตุการณ์บนแผนที่
- ปรับแต่งการควบคุมที่ปรากฏบนแผนที่
- ปรับแต่งท่าทางสัมผัสสำหรับการควบคุมแผนที่
- ควบคุมการซูมและการเลื่อนในแผนที่ (กล้อง)
- เปลี่ยนประเภทแผนที่
- เปลี่ยนรูปแบบสีของแผนที่
- เพิ่มเลเยอร์การจราจรลงในแผนที่
- สร้าง Quadtree เพื่อค้นหาจุดภายในพื้นที่ที่ระบุ
Maps SDK สำหรับ iOS: คำอธิบายประกอบของ Maps
- เพิ่มหน้าต่างข้อมูลลงในแผนที่
- เพิ่มรูปร่างหรือเส้นลงในแผนที่
- เพิ่มรูปภาพซ้อนทับที่เชื่อมต่อกับพื้นผิวของแผนที่
- เพิ่มการวางซ้อนการ์ดที่กำหนดเองลงในแผนที่
- เพิ่มเครื่องหมายลงในแผนที่ หมายเหตุ: Navigation SDK สำหรับ Android ไม่รองรับ AdvancedMarkerOptions เมื่อใช้ Navigation SDK สำหรับ Android ให้เพิ่มเครื่องหมายด้วย GoogleMap.addMarker(MarkerOptions)
- ปรับแต่งเครื่องหมายบนแผนที่ หมายเหตุ: Navigation SDK สำหรับ Android ไม่รองรับ AdvancedMarkerOptions เมื่อใช้ Navigation SDK สำหรับ Android ให้ปรับแต่งเครื่องหมายด้วย MarkerOptions
- ตอบสนองต่อการโต้ตอบของผู้ใช้ด้วยเครื่องหมายบนแผนที่
- ตรวจสอบว่าพิกัดอยู่ภายในรูปหลายเหลี่ยมหรือพื้นที่วงกลมบนแผนที่หรือไม่ หมายเหตุ: ใน Android ให้ใช้ PolyUtil.containsLocation ในไลบรารีของยูทิลิตี Maps SDK สำหรับ Android สำหรับรูปหลายเหลี่ยม สำหรับพื้นที่วงกลม ให้ตรวจสอบว่าระยะทางทรงกลมจากจุดศูนย์กลางของวงกลมอยู่ภายในรัศมีหรือไม่ (เช่น computeDistanceBetween ใน Maps JavaScript API, SphericalUtil.computeDistanceBetween ใน Android หรือ GMSGeometryDistance ใน iOS)
- คำนวณระยะทาง พื้นที่ หรือทิศทางทรงกลมระหว่างพิกัดบนแผนที่
Maps SDK สำหรับ iOS: การจัดสไตล์แผนที่
- สร้างรูปแบบแผนที่ข้ามแพลตฟอร์มที่นำกลับมาใช้ใหม่ได้
- เปลี่ยนรูปแบบของถนน เส้นประกอบ และรูปหลายเหลี่ยมบนแผนที่
- แสดงหรือซ่อนฟีเจอร์แผนที่
- เปลี่ยนรูปแบบของไอคอนและป้ายกำกับข้อความบนแผนที่
- ใช้รูปแบบแผนที่ที่แตกต่างกันกับระดับการซูมที่แตกต่างกัน
- เปลี่ยนความหนาแน่นของสถานที่บนแผนที่ ทดลอง
- เปลี่ยนรูปแบบของสิ่งปลูกสร้างบนแผนที่ ทดลอง
- เปลี่ยนรูปแบบของจุดสังเกตบนแผนที่ ทดลอง
Maps SDK สำหรับ iOS: Street View
- เพิ่ม Google Street View แบบอินเทอร์แอกทีฟที่กำหนดค่าได้ลงในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่
- เพิ่มเครื่องหมายหรือการวางซ้อนลงใน Google Street View
- ตอบสนองต่อการโต้ตอบและเหตุการณ์ของผู้ใช้ใน Google Street View
- ปรับแต่งท่าทางสัมผัสที่ใช้ได้กับ Google Street View
- สร้างภาพเคลื่อนไหวของการเคลื่อนกล้องสำหรับ Google Street View