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
- Dịch vụ cần bật:
navigationsdk.googleapis.com - Xác thực: Khoá API
- Đồng thời, hãy bật: SDK Maps dành cho iOS
- Phân bổ mức sử dụng: Gọi
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) để thêm mã phân bổ mức sử dụng vào trình khởi tạo. Để chọn không sử dụng, hãy xoá lệnh gọi hoặc truyền một chuỗi trống. - Bắt đầu: Thiết lập Navigation SDK cho iOS
- Tài liệu tham khảo: Tài liệu tham khảo về SDK điều hướng cho iOS
- Giá: Mức sử dụng và thông tin thanh toán của Navigation SDK cho iOS
- Chính sách: Chính sách về Navigation SDK cho iOS
- Ghi chú phát hành: Ghi chú phát hành SDK điều hướng cho iOS
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: sản phẩm có liên quan
- Thường dùng với: SDK bản đồ dành cho iOS, Routes API, Route Optimization API, Places SDK for iOS
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 = truetrong 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óNSMotionUsageDescriptiontrongInfo.plistsẽ 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êmNSMotionUsageDescription(Quyền riêng tư – Mô tả về việc sử dụng dữ liệu chuyển động) vàoInfo.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
.travelModeUnsupportedkhitravelModecủa ứng dụng không phải làdrivinghoặctwoWheeler. Cách khắc phục: ĐặtmapView.travelModethành.drivinghoặc.twoWheeler. Kiểm traresolvedParameters.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.
GMSNavigatorsetDestinations: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ể
GMSServicesappCheckTokenProvider: Ngừng hoạt động kể từ ngày 24 tháng 9 năm 2026. Thay thế: Thuộc tính lớpGMSServices.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 quaGMSServices.sharedServices()không thành công. Xem hướng dẫn di chuyển. GMSNavigatorcontinueToNextDestination: Không dùng nữa kể từ ngày 7 tháng 4 năm 2026. Thay thế:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsvà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 đồ
.terraintrong 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),.satellitehoặc.hybrid. - Giao thức
GMSNavigatorDelegatevàGMSRoadSnappedLocationProviderDelegate: Ngừng hoạt động kể từ ngày 13/5/2021. Thay thế:GMSNavigatorListenervàGMSRoadSnappedLocationProviderListener(thêm bằng-addListener:; đặttimeUpdateThresholdvàdistanceUpdateThresholdtrênGMSNavigator). 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
- Thêm tính năng chỉ đường từng chặng có tính tương tác vào ứng dụng di động.
- Đặt điểm đến cho tính năng chỉ đường từng chặng.
- Bắt đầu đường đi từng chặng.
- Chỉ định phương thức di chuyển (lái xe, đi bộ, xe hai bánh, taxi) cho một yêu cầu về tuyến đường.
- Sửa đổi lựa chọn ưu tiên về tuyến đường cho tính năng điều hướng từng chặng.
- Chỉ định bên đường và các lựa chọn ưu tiên khác về điểm đến cho tính năng đường đi từng chặng.
- Chỉ định tuyến đường được lập kế hoạch lại để đi theo từng chặng bằng mã thông báo tuyến đường có thể sử dụng lại.
- Trả về thông tin cập nhật về thời gian đến của người dùng trong một phiên đi theo chỉ dẫn từng chặng.
- Trả về thông báo cập nhật vị trí của người dùng cũ trong một phiên đi theo đường đi từng chặng.
- Trả về thông tin cập nhật về thời gian và khoảng cách trong một phiên đi theo chỉ dẫn từng chặng.
- Trả về thông tin cập nhật về thay đổi tuyến đường từ một phiên đường đi từng chặng.
- Trả về thông tin cập nhật về chế độ ban đêm từ một phiên đi theo chỉ dẫn từng chặng.
- Trả về thông tin cập nhật về tốc độ của người dùng trong một phiên đi theo chỉ dẫn từng chặng.
- Tuỳ chỉnh các phần tử trên giao diện người dùng và các nút điều khiển xuất hiện trong khi đi theo đường đi từng chặng.
- Thêm một phần tử trên giao diện người dùng mới vào đường đi từng chặng.
- Thêm chỉ báo tiến trình chuyến đi vào tính năng đường đi từng chặng.
- Tuỳ chỉnh các tính năng bản đồ xuất hiện trong chế độ đường đi từng chặng.
- Thêm lớp giao thông vào tính năng đường đi từng chặng.
- Sửa đổi chế độ xem và hành vi của camera cho tính năng điều hướng từng chặng.
- Tuỳ chỉnh đồng hồ tốc độ và cảnh báo giới hạn tốc độ cho tính năng đường đi từng chặng.
- Trả về nguồn cấp dữ liệu đường đi từng chặng dưới dạng một loạt thông báo cho mỗi thao tác dọc theo tuyến đường.
- Chỉ định biểu tượng thao tác tuỳ chỉnh để sử dụng với nguồn cấp dữ liệu đường đi từng chặng.
- Thêm tính năng đường đi từng chặng, có tính tương tác cho CarPlay vào một ứng dụng iOS. Xem trước
- Cảnh báo cho người dùng về tình trạng gián đoạn trên tuyến đường của họ.
- Cho phép người dùng xem các sự cố gián đoạn dọc theo tuyến đường của họ trước khi bắt đầu đi theo chỉ dẫn.
- Cho phép người dùng báo cáo sự cố trên tuyến đường của họ.
- Cho phép người dùng xác minh sự cố trên tuyến đường của họ.
- Thêm nút báo cáo sự cố trên tuyến đường tuỳ chỉnh.