Navigation SDK สำหรับ iOS เพิ่มการนำทางแบบเลี้ยวต่อเลี้ยวของ Google Maps ลงในแอป iOS พร้อมการปรับแต่ง UI และการกำหนดค่าเส้นทาง โดยจะขยาย Maps SDK สำหรับ iOS ซึ่งเป็นผู้จัดหาเลเยอร์ของแผนที่และต้องติดตั้งในแอปด้วย
Navigation SDK สำหรับ iOS: ข้อมูลสำคัญ
- ผลิตภัณฑ์: Navigation SDK สำหรับ iOS
- หรือที่เรียกว่า Navigation SDK
- หมวดหมู่: เส้นทาง
- แพลตฟอร์ม: iOS
- ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
- ระยะการเปิดตัว: GA
- วงจร: ใช้งานอยู่
- ภาพรวม: ภาพรวมของ Navigation SDK สำหรับ iOS
- ภูมิภาคที่พร้อมให้บริการ: จำกัด เส้นทางการขับขี่และเส้นทางเดินเท้าพร้อมให้บริการในประเทศส่วนใหญ่ ส่วนข้อมูลการจราจร การหยุดชะงักแบบเรียลไทม์ เส้นทางสำหรับรถจักรยานยนต์ เส้นทางปั่นจักรยาน ข้อมูลขีดจำกัดความเร็ว รวมถึงข้อมูลสัญญาณไฟจราจรและป้ายหยุดจะแตกต่างกันไปในแต่ละประเทศ (รายละเอียดความครอบคลุม)
Navigation SDK สำหรับ iOS: กรณีที่ควรใช้
ใช้ Navigation SDK สำหรับ iOS ในกรณีต่อไปนี้
- คุณต้องการการนำทางแบบเลี้ยวต่อเลี้ยวของ Google Maps ภายในแอป iOS แบบเนทีฟของคุณเองเพื่อให้ผู้ใช้ไม่ต้องเปลี่ยนแอป
- คุณต้องปรับแต่ง UI การนำทาง รูปแบบแผนที่ กล้อง หรือเลย์เอาต์ให้ตรงกับแบรนด์ของคุณในระหว่างการนำทาง
- คุณต้องมีค่ากำหนดเส้นทาง จุดอ้างอิงหลายจุด หรือโทเค็นเส้นทางจาก Routes API หรือ Route Optimization API
- คุณต้องมีเหตุการณ์การเดินทาง (ตำแหน่ง การมาถึง การเปลี่ยนแปลงเส้นทาง, ETA) หรือฟีดข้อมูลแบบเลี้ยวต่อเลี้ยวสำหรับ UI คำแนะนำที่กำหนดเองหรือ CarPlay
อย่าใช้ Navigation SDK สำหรับ iOS ในกรณีต่อไปนี้
- คุณกำลังสร้างแอป Android โปรดใช้ Navigation SDK สำหรับ Android แทน
- คุณกำลังสร้างแอป Flutter หรือ React Native ให้ใช้ Google Navigation สำหรับ Flutter และ React Native แทน
- คุณต้องการเพียงเส้นทาง, ETA หรือระยะทางบนเซิร์ฟเวอร์ โดยไม่มีคำแนะนำในแอป โปรดใช้ Routes API แทน
Navigation SDK สำหรับ iOS: การตั้งค่า
- บริการที่ต้องเปิดใช้:
navigationsdk.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- เปิดใช้ Maps SDK สำหรับ iOS ด้วย
- การระบุแหล่งที่มาของการใช้งาน: เรียกใช้
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) เพื่อเพิ่มรหัสการระบุแหล่งที่มาของการใช้งานลงใน Initializer หากต้องการเลือกไม่ใช้ ให้ลบการเรียกหรือส่งสตริงว่าง - เริ่มต้นใช้งาน: ตั้งค่า Navigation SDK สำหรับ iOS
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิงเกี่ยวกับ Navigation SDK สำหรับ iOS
- ราคา: การใช้งานและการเรียกเก็บเงินของ Navigation SDK สำหรับ iOS
- นโยบาย: นโยบาย Navigation SDK สำหรับ iOS
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Navigation SDK สำหรับ iOS
แพ็กเกจ Navigation SDK สำหรับ iOS อย่างเป็นทางการ
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
แพ็กเกจที่ไม่ควรใช้กับ Navigation SDK สำหรับ iOS
- cocoapods:
GoogleNavigationการเผยแพร่ CocoaPods เลิกใช้งานแล้วตั้งแต่เวอร์ชัน 11.0.0 และเข้าสู่โหมดการบำรุงรักษาเมื่อวันที่ 18-08-2025 โปรดใช้ Swift Package Manager แทน
Navigation SDK สำหรับ iOS: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Maps SDK สำหรับ iOS, Routes API, Route Optimization API, Places SDK สำหรับ iOS
Navigation SDK สำหรับ iOS: ข้อผิดพลาดที่พบบ่อย
- ปัญหา: หน้าจอมืดลงหรือปิดระหว่างการนำทางเนื่องจาก SDK ไม่ได้ปิดใช้ตัวจับเวลาไม่มีการใช้งานของ iOS วิธีแก้ไข: ตั้งค่า
UIApplication.shared.isIdleTimerDisabled = trueขณะนำทาง ดู /maps/documentation/navigation/ios-sdk/route - ปัญหา: SDK เวอร์ชันหลักในอนาคตจะใช้มาตรวัดความสูง (
CMAltimeter) และแอปที่ไม่มีNSMotionUsageDescriptionในInfo.plistจะขัดข้องเมื่อเริ่มต้นระบบ การเพิ่มคีย์ในตอนนี้จะไม่มีผลต่อลักษณะการทำงานปัจจุบัน วิธีแก้ไข: เพิ่มNSMotionUsageDescription(ความเป็นส่วนตัว - คำอธิบายการใช้งานการเคลื่อนไหว) ลงในInfo.plistดู /maps/documentation/navigation/ios-sdk/route - ปัญหา: Places SDK สำหรับ iOS ไม่ได้รวมอยู่ใน Navigation SDK (ตั้งแต่ Places SDK 5.0) ดังนั้นจึงไม่มีคลาส Places วิธีแก้ไข: ติดตั้ง Places SDK สำหรับ iOS แยกต่างหาก โดยใช้เวอร์ชันเดียวกับ Navigation SDK ดู /maps/documentation/navigation/ios-sdk/xcode-setup
- ปัญหา: การตั้งค่าปลายทางด้วยโทเค็นเส้นทางไม่สำเร็จโดยมีข้อผิดพลาด
.travelModeUnsupportedเมื่อtravelModeของแอปไม่ใช่drivingหรือtwoWheelerวิธีแก้ไข: ตั้งค่าmapView.travelModeเป็น.drivingหรือ.twoWheelerตรวจสอบresolvedParameters.travelModeเพื่อดูโหมดที่เส้นทางใช้ ดู /maps/documentation/navigation/ios-sdk/route-customizations
Navigation SDK สำหรับ iOS: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว
- การเผยแพร่ CocoaPods: เลิกใช้งานตั้งแต่วันที่ 06-08-2026 สิ่งที่ใช้แทน: Swift Package Manager อาการ: อยู่ในโหมดการบำรุงรักษาตั้งแต่วันที่ 18-08-2025 จะไม่มี CocoaPods เวอร์ชันใหม่หลังจากไตรมาสที่ 2 ปี 2026 ดูคำแนะนำในการย้ายข้อมูล
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback): เลิกใช้งานตั้งแต่วันที่ 2 พ.ย. 2026 การเปลี่ยนทดแทน:setDestinations:completionHandler:,setDestinations:routingOptions:completionHandler:,setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler)- พร็อพเพอร์ตี้อินสแตนซ์
appCheckTokenProviderของGMSServices: เลิกใช้งานตั้งแต่วันที่ 24-09-2026 การแทนที่: พร็อพเพอร์ตี้คลาสGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]) อาการ: ในเวอร์ชัน 11.1.0 การกำหนดค่า App Check ผ่านGMSServices.sharedServices()ไม่สำเร็จ ดูคำแนะนำในการย้ายข้อมูล GMSNavigatorcontinueToNextDestination: เลิกใช้งานตั้งแต่วันที่ 2026-04-07 การเปลี่ยนทดแทน:GMSNavigatorcontinueToNextDestinationWithCompletion:GMSUISettingsshowsTrafficLightsและshowsStopSigns: เลิกใช้งานตั้งแต่วันที่ 2026-08-06 การแทนที่: ไม่จำเป็นต้องแทนที่ เนื่องจากระบบจะแสดงสัญญาณไฟจราจรและป้ายหยุดโดยค่าเริ่มต้นระหว่างการนำทาง- ประเภทแผนที่
.terrainระหว่างการนำทางที่ใช้งานอยู่: เลิกใช้งานตั้งแต่วันที่ 2026-08-06 รายการทดแทน: แผนที่ประเภท.normal(kGMSTypeNormal),.satelliteหรือ.hybrid - โปรโตคอล
GMSNavigatorDelegateและGMSRoadSnappedLocationProviderDelegate: เลิกใช้งานตั้งแต่วันที่ 13 พฤษภาคม 2021 รายการทดแทน:GMSNavigatorListenerและGMSRoadSnappedLocationProviderListener(เพิ่มด้วย-addListener:; ตั้งค่าtimeUpdateThresholdและdistanceUpdateThresholdในGMSNavigator) ดูคำแนะนำในการย้ายข้อมูล
สิ่งที่คุณทำได้ด้วย Navigation SDK สำหรับ iOS
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
Navigation SDK สำหรับ iOS: การจัดสไตล์แผนที่
Navigation SDK สำหรับ iOS: การนำทาง
- เพิ่มการนำทางแบบเลี้ยวต่อเลี้ยวที่โต้ตอบได้ลงในแอปบนมือถือ
- ตั้งค่าจุดหมายสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- เริ่มการนำทางแบบเลี้ยวต่อเลี้ยว
- ระบุโหมดการเดินทาง (ขับรถ เดิน มอเตอร์ไซค์ แท็กซี่) สำหรับคำขอเส้นทาง
- แก้ไขค่ากำหนดเส้นทางสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- ระบุฝั่งถนนและค่ากำหนดการมาถึงอื่นๆ สำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- ระบุเส้นทางที่วางแผนใหม่สำหรับการนำทางแบบเลี้ยวต่อเลี้ยวด้วยโทเค็นเส้นทางที่นำกลับมาใช้ใหม่ได้
- แสดงข้อมูลอัปเดตการมาถึงของผู้ใช้ที่กลับมาจากการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงผลการอัปเดตตำแหน่งของผู้ใช้จากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตเกี่ยวกับเวลาและระยะทางจากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตการเปลี่ยนแปลงเส้นทางจากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตเกี่ยวกับโหมดกลางคืนจากเซสชันการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงข้อมูลอัปเดตความเร็วของผู้ใช้ที่กลับมาจากการนำทางแบบเลี้ยวต่อเลี้ยว
- ปรับแต่งองค์ประกอบ UI และการควบคุมที่ปรากฏระหว่างการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มองค์ประกอบ UI ใหม่ลงในการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มตัวบอกสถานะความคืบหน้าของการเดินทางลงในการนำทางแบบเลี้ยวต่อเลี้ยว
- ปรับแต่งฟีเจอร์แผนที่ที่ปรากฏระหว่างการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มเลเยอร์การจราจรลงในการนำทางแบบเลี้ยวต่อเลี้ยว
- แก้ไขมุมมองและลักษณะการทำงานของกล้องสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- ปรับแต่งการแจ้งเตือนมาตรวัดความเร็วและการจำกัดความเร็วสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว
- แสดงฟีดการนำทางแบบเลี้ยวต่อเลี้ยวเป็นชุดข้อความสำหรับการบังคับทิศทางแต่ละครั้งตลอดเส้นทาง
- ระบุไอคอนการบังคับทิศทางที่กำหนดเองเพื่อใช้กับฟีดการนำทางแบบเลี้ยวต่อเลี้ยว
- เพิ่มการนำทางแบบเลี้ยวต่อเลี้ยวแบบอินเทอร์แอกทีฟสำหรับ CarPlay ลงในแอป iOS เวอร์ชันตัวอย่าง
- แจ้งเตือนผู้ใช้เกี่ยวกับการหยุดชะงักตามเส้นทาง
- อนุญาตให้ผู้ใช้ดูการหยุดชะงักตามเส้นทางก่อนเริ่มการนำทาง
- อนุญาตให้ผู้ใช้รายงานการหยุดชะงักตามเส้นทาง
- อนุญาตให้ผู้ใช้ยืนยันการหยุดชะงักตามเส้นทาง
- เพิ่มปุ่มรายงานการหยุดชะงักของเส้นทางที่กำหนดเอง