Hỗ trợ NavigationFragment

lớp công khai SupportNavigationFragment mở rộng Fragment

Một thành phần điều hướng trong ứng dụng. Mảnh này là cách đơn giản nhất để sử dụng tính năng điều hướng trong ứng dụng. Đây là một trình bao bọc xung quanh chế độ xem của bản đồ điều hướng để tự động xử lý các nhu cầu cần thiết trong vòng đời hoạt động. Là một mảnh, bạn có thể thêm thành phần này vào tệp bố cục của hoạt động chỉ bằng đoạn mã XML ở bên dưới. 

 <fragment
    class="com.google.android.libraries.navigation.SupportNavigationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

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

Hàm SupportNavigationFragment()

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)
Xem
onCreateView(Trình tăng cường LayoutInflater, vùng chứa ViewGroup, gói savedInstanceState)
void
onDestroyView()
void
onLowMemory()
void
onPause()
void
onResume()
void
onSaveInstanceState(Gói outState)
void
Hàm onStart()
void
onStop()
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 forceNightMode)
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)
Thiết lập 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.
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 speedAlertUiOptions)
Đặ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 SupportNavigationFragment ()

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 đồ.

Trả bóng
  • đối tượng Camera liên kết với mảnh 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 đồ.

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 Xem onCreateView (LayoutInflater inflater, Vùng chứa ViewGroup, Gói savedInstanceState)

Các tham số
máy bơm hơi
vùng chứa
savedInstanceState

công khai void onDestroyView ()

công khai khoảng trống onLowMemory ()

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 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 forceNightMode)

Các tham số
forceNightMode

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)

Thiết lập 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. 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 MINOR và MAJOR. 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
Xem thêm

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 riêng biểu tượng giới hạn tốc độ

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
Xem thêm

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

Đặ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ố
speedAlertUiOptions

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.

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