Chế độ xem điều hướng

lớp công khai NavigationView mở rộng RelativeLayout

Một thành phần hiển thị cho thấy bản đồ để điều hướng.

Người dùng lớp này phải chuyển tiếp tất cả phương thức vòng đời từ Activity hoặc Fragment chứa thành phần hiển thị này sang các phương thức tương ứng trong lớp này. Cụ thể, bạn phải chuyển tiếp trên các phương thức sau:

Nếu NavView được thêm vào sau khi Activity hoặc Fragment mẹ đã trải qua vòng đời tạo, bạn phải gọi onCreate(Bundle), onStart()onResume() theo cách thủ công để khởi chạy đúng cách. Tương tự, nếu NavView bị tách khỏi Activity hoặc Fragment gốc, bạn phải gọi onPause(), onStop()onDestroy() theo cách thủ công để tránh rò rỉ dữ liệu.

Lưu ý: Bạn không nên thêm trẻ em vào chế độ xem này.

Tất cả lệnh gọi đến NavView phải được thực hiện trên luồng giao diện người dùng.

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

giao diện NavigationView.OnNightModeChangedListener Giao diện cho một trình nghe sẽ nhận được thông báo khi giao diện người dùng chuyển sang hoặc thoát khỏi "chế độ ban đêm". 
giao diện NavigationView.OnRecenterButtonClickedListener Giao diện của trình nghe sẽ được thông báo khi người dùng nhấp vào nút căn giữa. 

Tóm tắt hằng số kế thừa

Tóm tắt về trường kế thừa

Tóm tắt về hàm khởi tạo công khai

NavigationView(Ngữ cảnh)
NavigationView(Ngữ cảnh theo bối cảnh, thuộc tính AttributesSet)
NavigationView(Ngữ cảnh theo bối cảnh, thuộc tính AttributesSet, int defStyleAttr)

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

Máy ảnh
getCamera()
Trả về đối tượng máy ảnh có thể được dùng để thay đổi khung nhìn của bản đồ.
NavigationMap
getMap()
Trả về đối tượng có thể được dùng để thêm nội dung vào bản đồ.
void
onConfigurationChanged(Cấu hình cấu hình)
void
onCreate(Gói savedInstanceState)
void
void
void
void
onSaveInstanceState(Gói outState)
void
Hàm onStart()
void
onStop()
void
onTrimMemory(cấp độ int)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
Ghi đè chế độ hiển thị mặc định cho chú thích ETA trong khi điều hướng.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
Đặt chế độ định dạng thông tin chú thích cho chú thích tuyến.
void
setCompassEnabled(đã bật boolean)
Đặt xem la bàn có hiển thị hay không.
void
setCustomControl(Kiểm soát chế độ xem, vị trí CustomControlPosition)
Đặt khung hiển thị điều khiển tuỳ chỉnh sẽ xuất hiện ở một vị trí nhất định trong giao diện người dùng điều hướng.
void
setEtaCardEnabled(đã bật boolean)
Đặt liệu thẻ ETA có hiển thị trong khi điều hướng hay không.
void
setForceNightMode(int NightMode)
Đặt ForceNightMode hiện tại.
void
setHeaderEnabled(đã bật boolean)
Thiết lập liệu tiêu đề điều hướng từng chặng có hiển thị trong khi điều hướng hay không.
void
setOnNightModeChangedListener(NavigationView.OnNightModeChangedListener)
Đặt một trình nghe sẽ được thông báo ngay lập tức về trạng thái "chế độ ban đêm" hiện tại và mỗi khi giao diện người dùng chuyển sang hoặc thoát khỏi "chế độ ban đêm".
void
setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener trình nghe)
Thiết lập trình nghe sẽ được thông báo khi người dùng nhấp vào nút căn giữa.
void
setRecenterButtonEnabled(đã bật boolean)
Thiết lập có hiển thị nút căn giữa lại hay không.
void
setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions)
Đặt SpeedAlertOptions để tuỳ chỉnh các ngưỡng kích hoạt cho các SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(đã bật boolean)
Chỉ định xem biểu tượng giới hạn tốc độ có xuất hiện hay không.
void
setSpeedometerIconEnabled(đã bật boolean)
Chỉ định xem biểu tượng đồng hồ tốc độ có xuất hiện hay không.
void
setSpeedometerUiOptions(SpeedometerUiOptions SpeedometerUiOptions)
Đặt cấu hình giao diện người dùng cho đồng hồ tốc độ SpeedometerUiOptions dựa trên SpeedAlertSeverity.
void
setStylingOptions(StylingOptions StyleOptions)
Đặt một số tuỳ chọn định kiểu cho giao diện người dùng điều hướng.
void
setTrafficIncidentCardsEnabled(đã bật boolean)
Thiết lập xem có hiển thị thẻ sự cố giao thông khi người dùng nhấp vào biểu tượng sự cố giao thông hay không.
void
setTrafficPromptsEnabled(đã bật boolean)
Đặt có hiển thị lời nhắc về lưu lượng truy cập hay không.

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

Công ty xây dựng công cộng

công khai NavigationView (Ngữ cảnh)

Các tham số
bối cảnh

công khai NavigationView (Ngữ cảnh, thuộc tính AttributesSet)

Các tham số
bối cảnh
attrs

công khai NavigationView (Ngữ cảnh ngữ cảnh, giá trị thuộc tính AttributesSet, int defStyleAttr)

Các tham số
bối cảnh
attrs
defStyleAttr

Phương thức công khai

công khai Máy ảnh getCamera ()

Trả về đối tượng máy ảnh có thể được dùng để thay đổi khung nhìn của bản đồ. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Trả bóng
  • đối tượng Camera liên kết với khung hiển thị này

công khai NavigationMap getMap ()

Trả về đối tượng có thể được dùng để thêm nội dung vào bản đồ. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

công khai vô hiệu onConfigurationChanged (Cấu hình cấu hình)

Các tham số
cấu hình

công khai void onCreate (Bundle savedInstanceState)

Các tham số
savedInstanceState

công khai vô hiệu onDestroy ()

công khai vô hiệu onPause ()

công khai vô hiệu onResume ()

công khai void onSaveInstanceState (Bundle outState)

Các tham số
outState

công khai vô hiệu onStart ()

công khai vô hiệu onStop ()

công khai void onTrimMemory (cấp độ int)

Các tham số
cấp lần truy cập,

công khai khoảng không setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

Ghi đè chế độ hiển thị mặc định cho chú thích ETA trong khi điều hướng. Việc truyền giá trị rỗng sẽ đặt lại chế độ hiển thị mặc định.

Các tham số
calloutInfoDisplayModeOverride chế độ hiển thị mới mong muốn.

công khai void setCalloutInfoFormatOverrideRouteCalloutInfoFormat

Đặt chế độ định dạng thông tin chú thích cho chú thích tuyến. Nếu phương thức này không được gọi, các chú thích sẽ tuân theo hành vi như được xác định bởi RouteActionsInfoFormat.DEFAULT.

Các tham số
calloutInfoFormatOverride định dạng chú thích mới mà bạn muốn.

công khai khoảng trống setCompassEnabled (boolean enabled)

Đặt xem la bàn có hiển thị hay không. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Các tham số
đang bật

công khai void setCustomControl (Kiểm soát chế độ xem, vị trí CustomControlPosition)

Đặt khung hiển thị điều khiển tuỳ chỉnh sẽ xuất hiện ở một vị trí nhất định trong giao diện người dùng điều hướng. Nếu bất kỳ thành phần điều khiển tuỳ chỉnh nào đã tồn tại ở một vị trí nhất định, thì thành phần đó sẽ được thay thế. Việc gọi phương thức này với một giá trị đối tượng điều khiển rỗng sẽ xoá thành phần điều khiển tuỳ chỉnh ở một vị trí nhất định. Nếu chế độ điều khiển đã được thêm ở một vị trí khác hoặc đã có thành phần mẹ, thì chế độ điều khiển đó sẽ bị bỏ qua. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Các tham số
kiểm soát một khung hiển thị sẽ được định vị trong giao diện người dùng điều hướng
position xác định vị trí đặt chế độ điều khiển tuỳ chỉnh trong giao diện người dùng so với các chế độ điều khiển tích hợp sẵn.

công khai void setEtaCardEnabled (boolean enabled)

Đặt liệu thẻ ETA có hiển thị trong khi điều hướng hay không. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Các tham số
đang bật

công khai void setForceNightMode (int NightMode)

Đặt ForceNightMode hiện tại.

Các tham số
nightMode

công khai void setHeaderEnabled (boolean enabled)

Thiết lập liệu tiêu đề điều hướng từng chặng có hiển thị trong khi điều hướng hay không. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Các tham số
đang bật

công khai void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener)

Đặt một trình nghe sẽ được thông báo ngay lập tức về trạng thái "chế độ ban đêm" hiện tại và mỗi khi giao diện người dùng chuyển sang hoặc thoát khỏi "chế độ ban đêm". Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Lưu ý: Để tránh rò rỉ bộ nhớ, bạn nên gọi setOnNightModeChangedListener(null) khi không còn cần đến trình nghe nữa.

Các tham số
trình nghe một trình nghe sẽ được thông báo khi giao diện người dùng chuyển sang hoặc thoát khỏi chế độ ban đêm

công khai khoảng trống setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener)

Thiết lập trình nghe sẽ được thông báo khi người dùng nhấp vào nút căn giữa. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Lưu ý: Để tránh rò rỉ bộ nhớ, bạn nên gọi setOnRecenterButtonClickedListener(null) khi không còn cần đến trình nghe nữa.

Các tham số
trình nghe trình nghe sẽ được thông báo khi nhấp vào nút căn giữa

công khai khoảng không setRecenterButtonEnabled (boolean enabled)

Thiết lập có hiển thị nút căn giữa lại hay không. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Các tham số
đang bật

công khai void setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

Đặt SpeedAlertOptions để tuỳ chỉnh các ngưỡng kích hoạt cho các SpeedAlertSeverity.

Bạn có thể sử dụng phương thức này để tuỳ chỉnh các ngưỡng kích hoạt cảnh báo tốc độ theo tỷ lệ phần trăm cho cả cảnh báo MINORMAJOR. Bạn cũng có thể sử dụng phương thức này để định cấu hình thời gian (tính bằng giây) cần thiết để nâng cấp cảnh báo tốc độ từ MINOR lên MAJOR.

Khi bạn đặt null SpeedAlertOptions hoặc không đặt giá trị nào, cảnh báo tốc độ mặc định của NavSDK sẽ hiển thị: cảnh báo tốc độ hiển thị văn bản màu đỏ trên nền trắng/tối cho chế độ ban ngày/ban đêm khi tốc độ thấp hơn 5 dặm/giờ hoặc 10 km/giờ, và hiển thị văn bản trắng trên nền đỏ khi chạy quá tốc độ hơn 5 dặm/giờ hoặc 10 km/giờ.

Các tham số
speedAlertOptions

công khai void setSpeedLimitIconEnabled (boolean enabled)

Chỉ định xem biểu tượng giới hạn tốc độ có xuất hiện hay không. Chỉ gọi phương thức này trên luồng giao diện người dùng.

Khi được bật, một biểu tượng giới hạn tốc độ cho biết giới hạn tốc độ của đường sẽ xuất hiện ở góc bắt đầu dưới cùng trong khi hướng dẫn. Biểu tượng này chỉ xuất hiện ở những nơi có dữ liệu giới hạn tốc độ đáng tin cậy. Khi biểu tượng đồng hồ tốc độ hiển thị, chúng sẽ được đính kèm.

Nếu bạn bật nút căn giữa, thì biểu tượng giới hạn tốc độ sẽ tạm thời bị ẩn khi nút căn giữa xuất hiện.

Lưu ý: Người lái xe phải tuân thủ tất cả các biển báo đã đăng trên đường và chỉ sử dụng biểu tượng giới hạn tốc độ để tham khảo. Độ chính xác của dữ liệu giới hạn tốc độ không được đảm bảo. Bạn có thể báo cáo dữ liệu giới hạn tốc độ không chính xác bằng cách gửi yêu cầu trong Cổng thông tin hỗ trợ của Google Cloud.

Các tham số
đang bật

công khai vô hiệu setSpeedometerIconEnabled (boolean enabled)

Chỉ định xem biểu tượng đồng hồ tốc độ có xuất hiện hay không. Chỉ gọi phương thức này trên luồng giao diện người dùng.

Khi được bật, một biểu tượng đồng hồ tốc độ cho biết tốc độ của xe sẽ xuất hiện ở góc dưới cùng khởi động trong quá trình hướng dẫn. Khi biểu tượng giới hạn tốc độ hiển thị, các biểu tượng này sẽ được đính kèm và sau đó đồng hồ tốc độ có thể có các màu khác nhau cho văn bản và nền, tuỳ thuộc vào mức độ nghiêm trọng của tốc độ.

Việc bật biểu tượng giới hạn tốc độ cũng sẽ bật hoàn toàn biểu tượng giới hạn tốc độ. Tuy nhiên, bạn có thể sử dụng setSpeedLimitIconEnabled(boolean) để tắt/bật biểu tượng giới hạn tốc độ một cách riêng biệt.

Nếu bạn bật nút căn giữa lại, thì biểu tượng đồng hồ tốc độ sẽ tạm thời bị ẩn khi nút căn giữa xuất hiện.

Các tham số
đang bật

công khai khoảng trống setSpeedometerUiOptions (SpeedometerUiOptions speedometerUiOptions)

Đặt cấu hình giao diện người dùng cho đồng hồ tốc độ SpeedometerUiOptions dựa trên SpeedAlertSeverity. Chỉ gọi phương thức này trên luồng giao diện người dùng.

Bằng việc đặt SpeedometerUiOptions null, bạn sẽ xoá thành phần trước đó (nếu được đặt). Khi không có SpeedometerUiOptions nào được định cấu hình, giao diện người dùng đồng hồ tốc độ sẽ chuyển sang cấu hình mặc định của NavSDK cho các cảnh báo tốc độ của SpeedAlertSeverity khác:

  • Cảnh báo tốc độ MINOR ở chế độ ban ngày: văn bản màu đỏ trên nền trắng
  • Cảnh báo tốc độ MINOR ở chế độ ban đêm: văn bản màu đỏ trên nền tối
  • Cảnh báo tốc độ MAJOR ở chế độ ban ngày: văn bản màu trắng trên nền đỏ
  • Cảnh báo tốc độ MAJOR ở chế độ ban đêm: văn bản màu trắng trên nền đỏ

Các tham số
speedometerUiOptions

công khai void setStylingOptions (StylingOptions kiểuOptions)

Đặt một số tuỳ chọn định kiểu cho giao diện người dùng điều hướng. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Các tham số
stylingOptions

công khai void setTrafficIncidentCardsEnabled (boolean enabled)

Thiết lập xem có hiển thị thẻ sự cố giao thông khi người dùng nhấp vào biểu tượng sự cố giao thông hay không. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Xin lưu ý rằng khi tính năng chỉ đường có hướng dẫn đang chạy, thông tin chi tiết về sự cố giao thông sẽ xuất hiện trong lời nhắc. Để tắt thông tin chi tiết về sự cố giao thông trong khi di chuyển, bạn nên dùng setTrafficPromptsEnabled(boolean).

Các tham số
đang bật

công khai void setTrafficPromptsEnabled (boolean enabled)

Đặt có hiển thị lời nhắc về lưu lượng truy cập hay không. Lời nhắc về tình hình giao thông sẽ định kỳ xuất hiện để cập nhật cho người dùng về tình trạng giao thông trong quá trình di chuyển. Phương thức này chỉ được gọi trên luồng giao diện người dùng.

Các tham số
đang bật