Tài liệu tham khảo nhanh về Navigation SDK cho iOS

Navigation SDK cho iOS bổ sung tính năng chỉ đường từng chặng của Google Maps vào các ứng dụng iOS, cùng với khả năng tuỳ chỉnh giao diện người dùng và cấu hình tuyến đường. Thư viện này mở rộng SDK bản đồ dành cho iOS, cung cấp lớp bản đồ và cũng phải được cài đặt trong ứng dụng.

Navigation SDK cho iOS: thông tin chính

  • Sản phẩm: Navigation SDK cho iOS
  • Còn được gọi là: Navigation SDK
  • Danh mục: Tuyến đường
  • Nền tảng: iOS
  • Chạy trên: Ứng dụng khách (mã ứng dụng hoặc trình duyệt)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về SDK điều hướng cho iOS
  • Phạm vi cung cấp theo khu vực: Có giới hạn. Đường đi bộ và đường lái xe được cung cấp ở hầu hết các quốc gia; thông tin về tình hình giao thông, tình trạng gián đoạn theo thời gian thực, xe hai bánh, đi xe đạp, giới hạn tốc độ, đèn giao thông và biển báo dừng sẽ khác nhau tuỳ theo quốc gia. (thông tin chi tiết về phạm vi bảo hiểm)

Navigation SDK cho iOS: trường hợp sử dụng

Sử dụng SDK chỉ đường cho iOS khi:

  • Bạn cần có tính năng đường đi từng chặng của Google Maps trong ứng dụng iOS gốc của riêng mình để người dùng không phải chuyển đổi ứng dụng.
  • Bạn cần tuỳ chỉnh giao diện người dùng điều hướng, kiểu bản đồ, camera hoặc bố cục cho phù hợp với thương hiệu của mình trong quá trình hướng dẫn.
  • Bạn cần có lựa chọn ưu tiên về tuyến đường, nhiều điểm tham chiếu hoặc mã thông báo tuyến đường từ Routes API hoặc Route Optimization API.
  • Bạn cần có các sự kiện về chuyến đi (vị trí, điểm đến, thay đổi tuyến đường, thời gian đến dự kiến) hoặc nguồn cấp dữ liệu từng chặng cho giao diện người dùng chỉ đường tuỳ chỉnh hoặc CarPlay.

Không sử dụng SDK chỉ đường cho iOS khi:

  • Bạn đang xây dựng một ứng dụng Android. Hãy sử dụng Navigation SDK cho Android.
  • Bạn đang xây dựng một ứng dụng Flutter hoặc React Native. Hãy sử dụng Google Navigation cho Flutter và React Native.
  • Bạn chỉ cần tuyến đường, thời gian đến dự kiến hoặc khoảng cách trên máy chủ mà không cần hướng dẫn trong ứng dụng. Hãy sử dụng Routes API.

Navigation SDK cho iOS: thiết lập

Các gói Navigation SDK chính thức cho iOS:

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

Các gói không được dùng với SDK Điều hướng cho iOS:

  • cocoapods: GoogleNavigation. Bản phân phối CocoaPods không còn được dùng nữa kể từ phiên bản 11.0.0 và đã chuyển sang chế độ bảo trì vào ngày 18 tháng 8 năm 2025. Thay vào đó, hãy sử dụng Trình quản lý gói Swift.

Navigation SDK cho iOS: các lỗi thường gặp

  • Vấn đề: Màn hình mờ đi hoặc tắt trong khi di chuyển vì SDK không tắt bộ hẹn giờ rảnh của iOS. Cách khắc phục: Đặt UIApplication.shared.isIdleTimerDisabled = true trong khi điều hướng. Xem /maps/documentation/navigation/ios-sdk/route.
  • Vấn đề: Một bản phát hành chính trong tương lai của SDK sẽ sử dụng cao độ kế (CMAltimeter) và các ứng dụng không có NSMotionUsageDescription trong Info.plist sẽ gặp sự cố khi khởi chạy. Việc thêm khoá ngay bây giờ không ảnh hưởng đến hành vi hiện tại. Cách khắc phục: Thêm NSMotionUsageDescription (Quyền riêng tư – Mô tả về việc sử dụng dữ liệu chuyển động) vào Info.plist. Xem /maps/documentation/navigation/ios-sdk/route.
  • Vấn đề: SDK Địa điểm dành cho iOS không đi kèm với SDK Điều hướng (kể từ SDK Địa điểm phiên bản 5.0), nên thiếu các lớp Địa điểm. Cách khắc phục: Cài đặt riêng SDK Địa điểm cho iOS, sử dụng cùng phiên bản với SDK Điều hướng. Hãy xem /maps/documentation/navigation/ios-sdk/xcode-setup.
  • Vấn đề: Việc đặt điểm đến bằng mã thông báo tuyến đường không thành công và xảy ra lỗi .travelModeUnsupported khi travelMode của ứng dụng không phải là driving hoặc twoWheeler. Cách khắc phục: Đặt mapView.travelMode thành .driving hoặc .twoWheeler. Kiểm tra resolvedParameters.travelMode để xem chế độ mà tuyến đường sử dụng. Xem /maps/documentation/navigation/ios-sdk/route-customizations.

Navigation SDK cho iOS: các tính năng cũ và không dùng nữa

  • Phân phối CocoaPods: Ngừng hoạt động kể từ ngày 6 tháng 8 năm 2026. Thay thế: Trình quản lý gói Swift. Triệu chứng: Chế độ bảo trì kể từ ngày 18 tháng 8 năm 2025. Không có phiên bản CocoaPods mới sau quý 2 năm 2026. Xem hướng dẫn di chuyển.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): Không dùng nữa kể từ ngày 2 tháng 11 năm 2026. Thay thế: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • Thuộc tính thực thể GMSServices appCheckTokenProvider: Ngừng hoạt động kể từ ngày 24 tháng 9 năm 2026. Thay thế: Thuộc tính lớp GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Triệu chứng: Trong phiên bản 11.1.0, việc định cấu hình Kiểm tra ứng dụng thông qua GMSServices.sharedServices() không thành công. Xem hướng dẫn di chuyển.
  • GMSNavigator continueToNextDestination: Không dùng nữa kể từ ngày 7 tháng 4 năm 2026. Thay thế: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights và showsStopSigns: Ngừng hoạt động kể từ ngày 6 tháng 8 năm 2026. Thay thế: Không cần thay thế; đèn giao thông và biển báo dừng được hiển thị theo mặc định trong khi đi theo chỉ dẫn.
  • Loại bản đồ .terrain trong khi điều hướng: Ngừng hoạt động kể từ ngày 6 tháng 8 năm 2026. Thay thế: Loại bản đồ .normal (kGMSTypeNormal), .satellite hoặc .hybrid.
  • Giao thức GMSNavigatorDelegate và GMSRoadSnappedLocationProviderDelegate: Ngừng hoạt động kể từ ngày 13/5/2021. Thay thế: GMSNavigatorListener và GMSRoadSnappedLocationProviderListener (thêm bằng -addListener:; đặt timeUpdateThreshold và distanceUpdateThreshold trên GMSNavigator). Xem hướng dẫn di chuyển.

Những việc bạn có thể làm với Navigation SDK cho iOS

Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.

Navigation SDK cho iOS: Kiểu bản đồ

Navigation SDK cho iOS: Chỉ đường