ข้อมูลอ้างอิงฉบับย่อเกี่ยวกับ Navigation SDK สำหรับ iOS

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 ในกรณีต่อไปนี้

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: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: หน้าจอมืดลงหรือปิดระหว่างการนำทางเนื่องจาก 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 ดูคำแนะนำในการย้ายข้อมูล
  • GMSNavigator setDestinations: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() ไม่สำเร็จ ดูคำแนะนำในการย้ายข้อมูล
  • GMSNavigator continueToNextDestination: เลิกใช้งานตั้งแต่วันที่ 2026-04-07 การเปลี่ยนทดแทน: GMSNavigator continueToNextDestinationWithCompletion:
  • GMSUISettings showsTrafficLights และ 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: การนำทาง