API Navigation

lớp cuối cùng công khai NavigationApi mở rộng Đối tượng

Điểm truy cập vào Navigation API. Sử dụng các phương thức tĩnh trên lớp này để lấy thông tin tham chiếu đến Navigator.

Tóm tắt lớp lồng ghép

@giao diện NavigationApi.ErrorCode ErrorCode là mã trạng thái được getNavigator(Activity, NavigatorListener) và getNavigator(Application, NavigatorListener) trả về khi không thể lấy Navigator thành công. 
giao diện NavigationApi.NavigatorListener Đăng ký NavigatorListener với getNavigator(Activity, NavigatorListener) để được thông báo về trạng thái của Navigator đã nói. 
giao diện NavigationApi.OnTermsResponseListener Đăng ký OnTermsResponseListener với showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) để nhận thông báo khi người dùng chấp nhận hoặc từ chối các điều khoản và điều kiện. 

Tóm tắt phương thức công khai

boolean tĩnh
areTermsAccepted(Đơn đăng ký)
Trả về true nếu người dùng đã chấp nhận các điều khoản và điều kiện Điều hướng của Google trước đây.
tĩnh khoảng trống
dọn dẹp()
Xoá trạng thái nội bộ của các thành phần NavSDK.
đồng bộ hoá tĩnh ForegroundServiceManager
getForegroundServiceManager(Ứng dụng)
Lấy thực thể singleton ForegroundServiceManager.
Chuỗi tĩnh
getNavSDKVersion()
Trả về phiên bản NavSDK hiện tại.
tĩnh khoảng trống
getNavigator(Ứng dụng, lệnh gọi lại NavigationApi.NavigatorListener)
Lấy thực thể Navigator.
tĩnh khoảng trống
getNavigator(Hoạt động hoạt động, lệnh gọi lại NavigationApi.NavigatorListener, kiểm tra điều khoản TermsAndConditionsCheckOption)
Lấy thực thể Navigator.
tĩnh khoảng trống
getNavigator(Hoạt động hoạt động, lệnh gọi lại NavigationApi.NavigatorListener)
Tương đương với getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.
tĩnh khoảng trống
getNavigatorNoToS(Ứng dụng, lệnh gọi lại NavigationApi.NavigatorListener)
Lấy thực thể Navigator.
RoadSnappedLocationProvider tĩnh
getRoadSnappedLocationProvider(Ứng dụng)
Lấy một thực thể của RoadSnappedLocationProvider. Bạn có thể dùng thực thể này để đăng ký thông tin vị trí của người dùng bị chụp trên đường.
Tĩnh NavigationTransactionRecorder
getTransactionRecorder(Ứng dụng)
Lấy một thực thể của NavigationTransactionRecorder, có thể dùng để ghi lại các giao dịch liên quan đến việc chỉ đường.
đồng bộ hoá tĩnh khoảng trống
initForegroundServiceManager(Ứng dụng, mã thông báo số nguyên, String defaultMessage, nhà cung cấp NotificationContentProvider)
Khởi động thực thể ForegroundServiceManager với các đối số đã cung cấp.
tĩnh khoảng trống
resetTermsAccepted(Ứng dụng)
Đặt lại các điều khoản và điều kiện để thử nghiệm.
tĩnh khoảng trống
showTermsAndConditionsDialog(Hoạt động hoạt động, Tên công ty trong chuỗi, Tiêu đề chuỗi, trình nghe NavigationApi.OnTermsResponseListener)
Cho thấy hộp thoại hướng dẫn người dùng chấp nhận các điều khoản và điều kiện của Google Navigation (Điều hướng) của Google bằng giao diện mặc định.
tĩnh khoảng trống
showTermsAndConditionsDialog(Hoạt động hoạt động, Chuỗi công ty, Tiêu đề chuỗi, TermsAndConditionsUIParams uiParams, trình nghe NavigationApi.OnTermsResponseListener, TermsAndConditionsCheckOption termAndConditionsCheckOption)
Hiện hộp thoại hướng dẫn người dùng chấp nhận các điều khoản và điều kiện của Google Navigation.
tĩnh khoảng trống
showTermsAndConditionsDialog(Hoạt động hoạt động, Tên công ty của chuỗi, trình nghe NavigationApi.OnTermsResponseListener)
Cho thấy hộp thoại hướng dẫn người dùng chấp nhận các điều khoản và điều kiện của Google Navigation (Điều hướng) của Google bằng cách sử dụng tiêu đề và giao diện mặc định.

Tóm tắt phương thức kế thừa

Phương thức công khai

công khai tĩnh boolean areTermsAccepted (Application application)

Trả về true nếu người dùng đã chấp nhận các điều khoản và điều kiện Điều hướng của Google trước đây.

Bạn có thể sử dụng tính năng này để kiểm tra xem có nên cho thấy màn hình điều khoản sớm hơn trong ứng dụng hay không, thay vì khi người dùng sắp di chuyển đến một nơi nào đó. Ví dụ: có thể bạn nên kiểm tra giá trị này khi ứng dụng của bạn cho thấy các điều khoản và điều kiện khác để người dùng có thể chấp nhận mọi điều khoản và điều kiện bắt buộc của ứng dụng trong một tác vụ.

Các tham số
ứng dụng ứng dụng hiện tại
Trả bóng
  • true nếu người dùng đã chấp nhận các điều khoản. Nếu không, false

công khai tĩnh khoảng trống dọn dẹp ()

Xoá trạng thái nội bộ của các thành phần NavSDK. Nếu trình điều hướng hiện tại tồn tại, hướng dẫn sẽ bị dừng và tắt. Bạn không thể thực hiện cuộc gọi hướng dẫn nào trong tương lai từ Trình điều hướng này. Gọi phương thức này để khôi phục bộ nhớ khi ứng dụng của bạn không còn cần đến Trình điều hướng nữa và ứng dụng của bạn đã huỷ tất cả tham chiếu đến Trình điều hướng. Nếu ứng dụng của bạn yêu cầu Trình điều hướng sau lệnh gọi này, hãy sử dụng getNavigator() để tạo Trình điều hướng mới. Lưu ý: Việc tạo một Trình điều hướng mới cần nhiều thời gian. Hãy cân nhắc xem độ trễ ảnh hưởng như thế nào đến hiệu suất của ứng dụng so với lợi ích của bộ nhớ được khôi phục.

công khai tĩnh đồng bộ hoá ForegroundServiceManager getForegroundServiceManager (Ứng dụng)

Lấy thực thể singleton ForegroundServiceManager. Nếu initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) không được gọi trước getForegroundServiceManager(Application), thì mã thông báo, tin nhắn và trình cung cấp thông báo mặc định sẽ được sử dụng.

Các tham số
ứng dụng Application hiện tại

công khai tĩnh Chuỗi getNavSDKVersion ()

Trả về phiên bản NavSDK hiện tại.

công khai tĩnh khoảng trống getNavigator (Ứng dụng ứng dụng, lệnh gọi lại NavigationApi.NavigatorListener)

Lấy thực thể Navigator.

Nếu người dùng chưa đồng ý với các điều khoản và điều kiện, thì lệnh gọi lại sẽ ngay lập tức được kích hoạt kèm theo mã lỗi TERMS_NOT_ACCEPTED.

Lưu ý rằng Trình điều hướng là một singleton; nếu bạn gọi phương thức này nhiều lần, mỗi lệnh gọi sẽ trả về cùng một Trình điều hướng.

Các tham số
ứng dụng Application hiện tại
số gọi lại lệnh gọi lại sẽ được kích hoạt khi Navigator sẵn sàng hoặc xảy ra lỗi

công khai tĩnh khoảng trống getNavigator (Hoạt động hoạt động, lệnh gọi lại NavigationApi.NavigatorListener, TermsAndConditionsCheckOption termsCheck)

Lấy thực thể Navigator.

Nếu người dùng chưa đồng ý với các điều khoản và điều kiện, thì lệnh gọi này sẽ hiển thị hộp thoại khuyến khích người dùng tuân thủ các quy định của địa phương.

Nếu termsCheck là ENABLED, hộp thoại cũng sẽ chứa đường liên kết đến Điều khoản và điều kiện của SDK điều hướng. callback sẽ được gọi với lỗi TERMS_NOT_ACCEPTED nếu người dùng không chấp nhận các điều khoản này.

Lưu ý rằng Trình điều hướng là một singleton; nếu bạn gọi phương thức này nhiều lần, mỗi lệnh gọi sẽ trả về cùng một Trình điều hướng.

Các tham số
hoạt động Activity để hiển thị hộp thoại điều khoản và điều kiện (nếu chưa chấp nhận)
số gọi lại lệnh gọi lại sẽ được kích hoạt khi Navigator sẵn sàng hoặc xảy ra lỗi
termsCheck cho biết liệu có nên bỏ qua bước kiểm tra Điều khoản và điều kiện

công khai tĩnh khoảng trống getNavigator (Hoạt động hoạt động, lệnh gọi lại NavigationApi.NavigatorListener)

Tương đương với getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.

Các tham số
hoạt động
số gọi lại
Xem thêm

công khai tĩnh khoảng trống getNavigatorNoToS (Ứng dụng ứng dụng, lệnh gọi lại NavigationApi.NavigatorListener)

Lấy thực thể Navigator.

Bỏ qua các điều khoản và điều kiện.

Lưu ý rằng Trình điều hướng là một singleton; nếu bạn gọi phương thức này nhiều lần, mỗi lệnh gọi sẽ trả về cùng một Trình điều hướng.

Các tham số
ứng dụng Application hiện tại.
số gọi lại một lệnh gọi lại sẽ được kích hoạt khi Navigator đã sẵn sàng hoặc xảy ra lỗi.

công khai tĩnh RoadSnappedLocationProvider getRoadSnappedLocationProvider (Ứng dụng)

Lấy một thực thể của RoadSnappedLocationProvider. Bạn có thể dùng thực thể này để đăng ký thông tin vị trí của người dùng bị chụp trên đường. Xin lưu ý rằng việc đăng ký thông tin cập nhật vị trí được chụp nhanh trên đường có thể gây tiêu hao pin hoặc thu thập dữ liệu vị trí của người dùng ngoài ý muốn nếu vẫn chạy ở chế độ nền.

Bạn phải lấy Navigator thành công trước khi gọi phương thức này, nếu không, phương thức này sẽ trả về null.

Các tham số
ứng dụng Application hiện tại

công khai tĩnh NavigationTransactionRecorder getTransactionRecorder (Ứng dụng của ứng dụng)

Lấy một thực thể của NavigationTransactionRecorder, có thể dùng để ghi lại các giao dịch liên quan đến việc chỉ đường.

Bạn chỉ nên sử dụng lớp này khi và chỉ khi công ty của bạn được Google lập hoá đơn dựa trên từng giao dịch.

Bạn phải lấy Navigator thành công trước khi gọi phương thức này, nếu không, phương thức này sẽ trả về null.

Các tham số
ứng dụng Application hiện tại

công khai tĩnh khoảng trống được đồng bộ hoá initForegroundServiceManager (Ứng dụng ứng dụng, Integer notificationId, String defaultMessage, nhà cung cấp NotificationContentProvider)

Khởi động thực thể ForegroundServiceManager với các đối số đã cung cấp.

Tham số này chỉ nên được gọi nếu bạn muốn sửa đổi bất kỳ tham số mặc định nào. Nếu không, hãy gọi trực tiếp getForegroundServiceManager(Application). Phương thức này chỉ có thể được gọi một lần và phải được gọi trước getForegroundServiceManager(Application).

Các tham số
ứng dụng Application hiện tại
notificationId mã thông báo của thông báo liên tục
defaultMessage thông báo mặc định sẽ hiển thị nếu không chỉ định provider
nhà cung cấp bản triển khai NotificationContentProvider

công khai tĩnh void resetTermsAccepted (Application application)

Đặt lại các điều khoản và điều kiện để thử nghiệm. Hãy thêm lệnh gọi vào hàm này trước bất kỳ lệnh gọi nào đến NavigationApi nếu bạn muốn kiểm thử hộp thoại điều khoản và điều kiện.

Các tham số
ứng dụng ứng dụng hiện tại

công khai tĩnh khoảng trống showTermsAndConditionsDialog (Activity activity, String companyName, String title, NavigationApi.OnTermsResponseListener)

Cho thấy hộp thoại hướng dẫn người dùng chấp nhận các điều khoản và điều kiện của Google Navigation (Điều hướng) của Google bằng giao diện mặc định.

Các tham số
hoạt động
companyName
tiêu đề
trình nghe
Xem thêm

public static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener trình nghe, TermsAndConditionsCheckOption termsAndConditionsCheckOption

Hiện hộp thoại hướng dẫn người dùng chấp nhận các điều khoản và điều kiện của Google Navigation. Nếu được chỉ định, trình nghe sẽ được gọi trên luồng giao diện người dùng, cho biết liệu người dùng có chấp nhận các điều khoản và điều kiện hay không.

Lưu ý rằng hộp thoại sẽ xuất hiện ngay cả khi người dùng đã chấp nhận trước đó. Chỉ nên gọi phương thức này nếu areTermsAccepted(Application) là false, vì người dùng không thể từ chối các điều khoản và điều kiện.

Các tham số
hoạt động Activity mà hộp thoại sẽ hiển thị
companyName tên công ty của bạn, tên này sẽ xuất hiện trong hộp thoại điều khoản và điều kiện
tiêu đề tiêu đề của hộp thoại. Nếu giá trị rỗng, hộp thoại sẽ sử dụng tiêu đề mặc định.
uiParams các tham số dùng để tuỳ chỉnh giao diện của hộp thoại. Nếu giá trị rỗng, giao diện mặc định sẽ được sử dụng.
trình nghe một lệnh gọi lại (không bắt buộc) sẽ được kích hoạt khi người dùng chấp nhận hoặc từ chối các điều khoản và điều kiện
termsAndConditionsCheckOption TermsAndConditionsCheckOption chỉ định các tuỳ chọn để kiểm tra điều khoản và điều kiện

công khai tĩnh khoảng trống showTermsAndConditionsDialog (Hoạt động hoạt động, String companyName, trình nghe NavigationApi.OnTermsResponseListener)

Cho thấy hộp thoại hướng dẫn người dùng chấp nhận các điều khoản và điều kiện của Google Navigation (Điều hướng) của Google bằng cách sử dụng tiêu đề và giao diện mặc định.

Các tham số
hoạt động
companyName
trình nghe
Xem thêm