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

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

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

  • maven: com.google.android.libraries.navigation:navigation

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-maps trự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-maps khỏ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 NavigationView khi sử dụng NavigationFragment hoặc gọi các phương thức đó không theo thứ tự với NavigationView sẽ dẫn đến lỗi. Cách khắc phục: Sử dụng NavigationFragment để quản lý các phương thức gọi lại trong vòng đời. Nếu bạn sử dụng NavigationView, 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

  • Waypoint fromLatLng() 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.
  • setLocationMarkerEnabled trên NavigationView và 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.
  • DisplayOptions showTrafficLights và 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:navigation từ kho lưu trữ Maven google(). Triệu chứng: Phiên bản 5.0 trở lên chỉ được cung cấp dưới dạng com.google.android.libraries.navigation:navigation trê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

Navigation SDK cho Android: Chú thích trên bản đồ

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

Navigation SDK cho Android: Navigation