Navigation SDK cho Android bổ sung tính năng chỉ đường từng chặng của Google Maps vào các ứng dụng Android, đồng thời cho phép tuỳ chỉnh giao diện người dùng và định cấu hình tuyến đường. Thư viện này bao gồm lớp bản đồ của SDK Maps, vì vậy, các ứng dụng sử dụng thư viện này cũng không thể bao gồm SDK Maps cho Android.
Navigation SDK cho Android: thông tin chính
- Sản phẩm: Navigation SDK cho Android
- Còn được gọi là: Navigation SDK
- Danh mục: Tuyến đường
- Nền tảng: Android
- 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ề Navigation SDK cho Android
Navigation SDK cho Android: trường hợp nên sử dụng
Sử dụng Navigation SDK cho Android khi:
- Bạn cần có tính năng đường đi từng chặng của Google Maps trong ứng dụng Android của riêng mình để người dùng không chuyển sang ứng dụng khác.
- Bạn cần tuỳ chỉnh giao diện người dùng điều hướng cho phù hợp với thương hiệu của mình hoặc xây dựng trải nghiệm điều hướng tuỳ chỉnh.
- Bạn cần có tính năng đi theo chỉ dẫn trong ứng dụng khi lái xe, đi bộ, đạp xe hoặc đi xe hai bánh.
- Bạn cần đi theo một tuyến đường mà bạn đã lên kế hoạch bằng Routes API bằng cách truyền mã thông báo tuyến đường đến SDK.
Không sử dụng SDK điều hướng cho Android khi:
- Bạn đang tạo ứng dụng cho iOS. Thay vào đó, hãy sử dụng Navigation SDK cho iOS.
- Bạn đang xây dựng một ứng dụng nhiều nền tảng bằng Flutter hoặc React Native. Thay vào đó, hãy sử dụng Google Navigation cho Flutter và React Native.
- Bạn cần tính toán tuyến đường, thời gian đến dự kiến hoặc mã thông báo tuyến đường phía máy chủ, chứ không phải hướng dẫn từng chặng trong ứng dụng. Hãy sử dụng Routes API.
Navigation SDK cho Android: thiết lập
- Dịch vụ cần bật:
navigationsdk.googleapis.com - Xác thực: Khoá API
- Phân bổ mức sử dụng: Gọi
MapsApiSettings.addInternalUsageAttributionId(context, id)để 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 SDK điều hướng cho Android
- Tài liệu tham khảo: Tài liệu tham khảo về SDK điều hướng cho Android
- Giá: Mức sử dụng và thanh toán cho Navigation SDK cho Android
- Chính sách: Chính sách của Navigation SDK cho Android
- Ghi chú phát hành: Ghi chú phát hành Navigation SDK cho Android
Các gói Navigation SDK chính thức cho Android:
- maven:
com.google.android.libraries.navigation:navigation
Navigation SDK cho Android: sản phẩm có liên quan
- Thường dùng với: Routes API, Driver SDK cho Android
Navigation SDK cho Android: các lỗi thường gặp
- Vấn đề: SDK điều hướng đã tích hợp sẵn SDK Maps. Các bản dựng lấy
play-services-mapstrực tiếp hoặc thông qua một phần phụ thuộc bắc cầu sẽ có các bản sao SDK Maps trùng lặp. Cách khắc phục: Loại trừcom.google.android.gms:play-services-mapskhỏi tất cả các phần phụ thuộc (loại trừ cấu hình Gradle hoặc loại trừ Maven) và xoá mọi phần phụ thuộc trực tiếp của SDK Maps. Xem /maps/documentation/navigation/android-sdk/android-studio-setup. - Vấn đề: SDK điều hướng 8.0 trở lên khai báo
minAndroidGradlePluginVersion=9.0.1, vì vậy, các bản dựng có AGP cũ hơn sẽ không thành công. Cách khắc phục: Nâng cấp lên AGP 9.0.1, Gradle 9.1.0 và Kotlin 2.3.0 trước khi bạn tạo bằng phiên bản 8.0 trở lên. Xem /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration. - Vấn đề: Việc gọi trực tiếp các phương thức trong vòng đời của
NavigationViewkhi sử dụngNavigationFragmenthoặc gọi các phương thức đó không theo thứ tự vớiNavigationViewsẽ dẫn đến lỗi. Cách khắc phục: Sử dụngNavigationFragmentđể quản lý các phương thức gọi lại trong vòng đời. Nếu bạn sử dụngNavigationView, hãy chuyển tiếp các phương thức vòng đời theo thứ tự nghiêm ngặt. Xem /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices. - Vấn đề: Người dùng không thể sử dụng tính năng chỉ đường cho đến khi chấp nhận Điều khoản dịch vụ của Google về tính năng chỉ đường. Cách khắc phục: Cho phép SDK nhắc người dùng trong lần đầu tiên trình điều hướng được gọi hoặc hiện hộp thoại sớm hơn (ví dụ: trong quá trình đăng ký) bằng
TermsAndConditionsCheckOption/NavigationApi.showTermsAndConditionsDialog. Xem /maps/documentation/navigation/android-sdk/route.
Navigation SDK cho Android: các tính năng cũ và không dùng nữa
WaypointfromLatLng()vàfromPlaceId(): Ngừng hoạt động kể từ ngày 10 tháng 5 năm 2021. Thay thế:Waypoint.builder()(Waypoint.Builder). Dấu hiệu: Đã bị loại bỏ trong phiên bản 3.0; các lệnh gọi không biên dịch được với phiên bản 3.0 trở lên. Xem hướng dẫn di chuyển.SupportNavigationFragment: Ngừng hoạt động kể từ ngày 1 tháng 10 năm 2026. Thay thế:NavigationFragment. Triệu chứng: Không dùng nữa trong SDK điều hướng phiên bản 8.0.0. Xem hướng dẫn di chuyển.setLocationMarkerEnabledtrênNavigationViewvàSupportNavigationFragment: Ngừng hoạt động kể từ ngày 7 tháng 7 năm 2023. Thay thế:GoogleMap.setMyLocationEnabled. Triệu chứng: Đã bị xoá trong phiên bản 5.0.0 (không dùng nữa trong phiên bản 4.1); các lệnh gọi không biên dịch được trong phiên bản 5.0 trở lên.DisplayOptionsshowTrafficLightsvàshowStopSigns: Ngừng hoạt động kể từ ngày 1 tháng 10 năm 2026. Thay thế: Không cần thay thế; đèn giao thông và biển báo dừng luôn được bật trong khi đi theo chỉ dẫn. Triệu chứng: Các lệnh gọi đến những phương thức này không biên dịch được đối với phiên bản 8.0.0.- Cấu phần phần mềm Maven
com.google.android.maps:navsdk(kho lưu trữ riêng tư, phiên bản 4.x) và tệp tải xuống gói AAR: Ngừng hoạt động kể từ ngày 7 tháng 7 năm 2023. Thay thế:com.google.android.libraries.navigation:navigationtừ kho lưu trữ Mavengoogle(). Triệu chứng: Phiên bản 5.0 trở lên chỉ được cung cấp dưới dạngcom.google.android.libraries.navigation:navigationtrên Google Maven; gói AAR không còn được phân phối nữa. Xem hướng dẫn di chuyển.
Những việc bạn có thể làm với Navigation SDK cho Android
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 Android: Maps
- Thêm bản đồ tương tác, có thể tuỳ chỉnh vào trang web hoặc ứng dụng di động. Lưu ý: Đối với Android: Định cấu hình
trongAndroidManifest.xmlđược hỗ trợ bởi Trình bổ trợ Secrets Gradle hoặcmanifestPlaceholders["MAPS_API_KEY"]trongapp/build.gradle.kts. Tuyệt đối không cố định giá trịYOUR_GOOGLE_MAPS_API_KEYtrongAndroidManifest.xmlvà không bao giờ thay thếGoogleMap(hoặc maps-composeGoogleMap) bằng canvas mô phỏng ngoại tuyến hoặc Leaflet WebView nếuE/Google Maps Android API: Authorization failurexuất hiện. Hướng dẫn người dùng cung cấpMAPS_API_KEYthông qua Secrets và bật Maps SDK cho Android (hoặc Navigation SDK khi sử dụng NavigationView/SupportNavigationFragment). - Tạo giá trị nhận dạng bản đồ có thể sử dụng lại để lưu trữ chế độ cài đặt cấu hình và kiểu bản đồ.
- Phản hồi các lượt tương tác và sự kiện của người dùng trên bản đồ.
- Tuỳ chỉnh các nút điều khiển xuất hiện trên bản đồ.
- Tuỳ chỉnh cử chỉ để điều khiển bản đồ.
- Điều khiển tính năng thu phóng và xoay trên bản đồ (máy ảnh).
- Thay đổi loại bản đồ.
- Thay đổi bảng phối màu của bản đồ.
- Thêm lớp giao thông vào bản đồ.
Navigation SDK cho Android: Chú thích trên bản đồ
- Thêm cửa sổ thông tin vào bản đồ.
- Thêm hình dạng hoặc đường kẻ vào bản đồ.
- Thêm lớp phủ hình ảnh được neo vào bề mặt của bản đồ.
- Thêm lớp phủ ô tuỳ chỉnh vào bản đồ.
- Thêm điểm đánh dấu vào bản đồ. Lưu ý: Navigation SDK cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng Navigation SDK cho Android, hãy thêm điểm đánh dấu bằng GoogleMap.addMarker(MarkerOptions).
- Tuỳ chỉnh điểm đánh dấu trên bản đồ. Lưu ý: SDK điều hướng cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng SDK điều hướng cho Android, hãy tuỳ chỉnh điểm đánh dấu bằng MarkerOptions.
- Phản hồi hoạt động tương tác của người dùng với điểm đánh dấu trên bản đồ.
Navigation SDK cho Android: Kiểu bản đồ
Navigation SDK cho Android: Navigation
- 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 chỉ đường từng chặng, có tính tương tác cho Android Auto vào một ứng dụng Android. Bản dùng 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.