Giải pháp cưỡi xe và giao hàng theo yêu cầu hiện chỉ dành cho một số đối tác. Liên hệ với bộ phận bán hàng để tìm hiểu thêm.

Trang này được dịch bởi Cloud Translation API.

Trình điều hướng

giao diện công khai Navigator

Một singleton cung cấp các phương thức để điều khiển hoạt động điều hướng.

Tất cả các phương thức đều được đảm bảo an toàn theo luồng, ngoại trừ setAudioHướng dẫn và setHeadsUpNotificationEnabled phải được gọi trên luồng giao diện người dùng.

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

giao diện	Navigator.ArrivalListener	Xác định chữ ký cho các phương thức được gọi khi trình điều khiển đến một điểm tham chiếu.
@giao diện	Navigator.AudioGuidance	Hướng dẫn bằng âm thanh là một bộ cờ dùng để chỉ định loại cảnh báo và hướng dẫn bằng âm thanh được dùng trong quá trình chỉ đường.
giao diện	Navigator.RemainingTimeOrDistanceChangedListener	Xác định chữ ký cho các phương thức được gọi khi thời gian hoặc khoảng cách còn lại đến đích đến tiếp theo thay đổi.
giao diện	Navigator.RouteChangedListener	Xác định chữ ký cho các phương thức được gọi khi tuyến này thay đổi.
enum	Navigator.RouteStatus	Tuyến trạng thái là một mã trạng thái biểu thị kết quả tính toán tuyến đường, được truy cập thông qua Tương lai do `setDestination(Waypoint)` trả về.

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

trừu tượng khoảng trống	dọn dẹp() Xoá trạng thái bên trong của Trình điều hướng.
trừu tượng khoảng trống	clearDestinations() Xoá tất cả các điểm đến đã đặt trước đó và mọi tuyến đường đã được tính toán khỏi bản đồ.
trừu tượng khoảng trống	clearLicensePlateRestrictionInfo() Xoá thông tin biển số xe của người lái xe hiện tại.
trừu tượng khoảng trống	clearRemainingTimeOrDistanceChangedListener() Xoá trình nghe khi có các thay đổi về thời gian hoặc khoảng cách còn lại.
bản tóm tắt Điểm tham chiếu	continueToNextDestination() Xoá đích đến hiện tại.
bản tóm tắt ListenableResultFuture<RouteInfo>	fetchRouteInfo(Điểm tham chiếu Điểm tham chiếu, RoutingOptions) Trả về thông tin tuyến đường của các tuyến dựa trên từng giá trị của `RoutingOptions.RoutingStrategy`.
Bản tóm tắt RouteSegment	getCurrentRouteSegment() Trả về chặng hiện tại của hành trình.
bản tóm tắt TimeAndDistance	getCurrentTimeAndDistance() Trả về thời gian ước tính và khoảng cách từ vị trí hiện tại đến điểm đến hiện tại.
bản tóm tắt Danh sách<RouteSegment>	getRouteSegments() Trả về danh sách các đoạn tuyến.
bản tóm tắt Trình mô phỏng	getSimulator() Trả về một đối tượng Trình mô phỏng để sử dụng trong quá trình kiểm thử.
bản tóm tắt Danh sách<TimeAndDistance>	getTimeAndDistanceList() Trả về danh sách thời gian và khoảng cách tương ứng với từng điểm đến trong tuyến đường hiện tại, thể hiện thời gian và khoảng cách ước tính từ vị trí hiện tại đến từng điểm đến.
bản tóm tắt Danh sách<LatLng>	getTraveledRoute() Trả về tuyến đường đã đi cho đến hiện tại trong phiên hướng dẫn này (kể từ lệnh gọi gần đây nhất đến `startGuidance()`).
trừu tượng boolean	isGuidanceRunning() Trả về `true` nếu hướng dẫn hiện đang chạy.
trừu tượng khoảng trống	setArrivalListener(trình nghe Navigator.ArrivalListener) Đăng ký một trình nghe sự kiện đến.
trừu tượng khoảng trống	setAudioGuidance(hướng dẫn bằng int) Đặt loại hướng dẫn bằng âm thanh (bao gồm cả rung) được bật.
Bản tóm tắt ListenableResultFuture<Navigator.RouteStatus>	setDestination(đích đến Waypoint, RoutingOptions33Tuỳ chọn, DisplayOptions displayOptions) Đặt một đích đến duy nhất cho hoạt động điều hướng, ghi đè mọi đích đến đã đặt trước đó.
Bản tóm tắt ListenableResultFuture<Navigator.RouteStatus>	setDestination(đích đến Waypoint, các tuỳ chọn RoutingOptions) Đặt một đích đến duy nhất cho hoạt động điều hướng, ghi đè mọi đích đến đã đặt trước đó.
Bản tóm tắt ListenableResultFuture<Navigator.RouteStatus>	setDestination(Đích đến Waypoint) Đặt một đích đến duy nhất cho hoạt động điều hướng, ghi đè mọi đích đến đã đặt trước đó.
Bản tóm tắt ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Đích đến List<Waypoint>, tuỳ chọn RoutingOptions) Đặt nhiều đích đến để điều hướng, ghi đè mọi đích đến đã đặt trước đó.
Bản tóm tắt ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Danh sách<Waypoint> đích, RoutingOptions navigationOptions, DisplayOptions displayOptions) Đặt nhiều đích đến để điều hướng, ghi đè mọi đích đến đã đặt trước đó.
Bản tóm tắt ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Đích đến trong danh sách<Waypoint>) Đặt nhiều đích đến để điều hướng, ghi đè mọi đích đến đã đặt trước đó.
trừu tượng khoảng trống	setHeadsUpNotificationEnabled(đã bật boolean) Đặt có hiển thị thông báo quan trọng hay không.
trừu tượng khoảng trống	setLicensePlateRestrictionInfo(int RAWLicensePlateLastDigit, Chuỗi LicensePlateCountryCode) Đặt thông tin biển số xe của người lái xe hiện tại.
trừu tượng khoảng trống	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, intwideChangeThresholdMeters, trình nghe Navigator.RemainingTimeOrDistanceChangedListener) Đăng ký trình nghe khi thời gian hoặc khoảng cách còn lại tới đích đến thay đổi nhiều hơn một ngưỡng đã chỉ định.
trừu tượng khoảng trống	setRouteChangedListener(trình nghe Navigator.RouteChangedListener) Đăng ký một trình nghe cho các sự kiện thay đổi tuyến đường.
trừu tượng khoảng trống	setSpeedingListener(SpeedingListener SpeedingListener) Đăng ký `SpeedingListener` cho tỷ lệ phần trăm vượt quá giới hạn tốc độ mà người lái xe hiện đang lái.
trừu tượng khoảng trống	startGuidance(Ý định resumeÝ định) Giống như `startGuidance()`, nhưng chỉ định một ý định có thể dùng để tiếp tục ứng dụng từ thông báo trên thanh trạng thái của trình điều hướng.
trừu tượng khoảng trống	startGuidance() Nếu đã đặt một đích đến và tính toán tuyến đường cho vị trí đó, thì hệ thống sẽ bắt đầu hướng dẫn chỉ đường từng chặng cho tuyến đường đó.
trừu tượng khoảng trống	stopGuidance() Dừng hướng dẫn chỉ đường từng chặng.

Phương thức công khai

công khai trừu tượng khoảng trống Dọn dẹp ()

Xoá trạng thái bên trong của Trình điều hướng.

Lưu ý: việc gọi phương thức này sẽ huỷ mọi yêu cầu đang chờ xử lý đến setDestinations(List).

công khai trừu tượng khoảng trống clearDestinations ()

Xoá tất cả các điểm đến đã đặt trước đó và mọi tuyến đường đã được tính toán khỏi bản đồ. Nếu đang chỉ đường, thì thao tác này sẽ tự động dừng hoạt động đó.

công khai trừu tượng void clearLicensePlateRestrictionInfo ()

Xoá thông tin biển số xe của người lái xe hiện tại. Giá trị này chỉ áp dụng cho các lệnh gọi setDestination được thực hiện sau khi bạn đặt giá trị này.

công khai trừu tượng khoảng trống clearRemainingTimeOrDistanceChangedListener ()

Xoá trình nghe khi có các thay đổi về thời gian hoặc khoảng cách còn lại.

công khai tóm tắt Waypoint continueToNextDestination ()

Xoá đích đến hiện tại. Sau lệnh gọi này, hướng dẫn sẽ chuyển đến đích đến tiếp theo và thông tin về đích đến cũ sẽ không có sẵn.

Trả bóng

hướng dẫn điểm tham chiếu hiện đang hướng tới hoặc rỗng nếu không còn điểm tham chiếu nào

công khai trừu tượng ListenableResultFuture<RouteInfo> fetchRouteInfo (Waypoint điểm tham chiếu, RoutingOptions tuỳ chọn định tuyến)

Trả về thông tin tuyến đường của các tuyến dựa trên từng giá trị của RoutingOptions.RoutingStrategy. RoutingOptions.RoutingStrategy bị bỏ qua vì phương thức này trả về thông tin tuyến đường cho tất cả các chiến lược định tuyến.

Lưu ý: Giá trị này được tính toán lại mỗi lần gọi và có thể không khớp với các tuyến hiện đang được sử dụng trong chỉ đường vì tình trạng giao thông và các yếu tố khác có thể đã được cập nhật trong thời gian chờ đợi.

Các tham số

điểm tham chiếu	điểm tham chiếu đích của tuyến đường
routingOptions	các tuỳ chọn dùng để tìm nạp thông tin tuyến đường

Trả bóng

tương lai trả về

công khai trừu tượng RouteSegment getCurrentRouteSegment ()

Trả về chặng hiện tại của hành trình. Tuyến đường này sẽ có vị trí bắt đầu là vị trí được biết đến gần đây nhất (bắt đầu đường) của thiết bị.

Trả bóng

một đối tượng đoạn tuyến đường hoặc null nếu không có tuyến đường hiện tại nào

công khai bản tóm tắt TimeAndDistance getCurrentTimeAndDistance ()

Trả về thời gian ước tính và khoảng cách từ vị trí hiện tại đến điểm đến hiện tại.

Trả bóng

đối tượng thời gian và khoảng cách hoặc null nếu không có tuyến đường hiện tại

công khai bản tóm tắt Danh sách<RouteSegment> getRouteSegments ()

Trả về danh sách các đoạn tuyến. Đích đến của mỗi phân đoạn được trả về sẽ tương ứng với một đích đến do setDestination(s).

công khai tóm tắt Trình mô phỏng getSimulator ()

Trả về một đối tượng Trình mô phỏng để sử dụng trong quá trình kiểm thử.

công khai bản tóm tắt Danh sách<TimeAndDistance> getTimeAndDistanceList ()

Trả về danh sách thời gian và khoảng cách tương ứng với từng điểm đến trong tuyến đường hiện tại, thể hiện thời gian và khoảng cách ước tính từ vị trí hiện tại đến từng điểm đến.

công khai bản tóm tắt Danh sách<LatLng> getTraveledRoute ()

Trả về tuyến đường đã đi từ trước đến nay trong phiên hướng dẫn này (kể từ lệnh gọi gần đây nhất đến startGuidance()). Tuyến đường được ghi lại bao gồm các vị trí bị chụp đường như sẽ được RoadSnappedLocationProvider trả về và được đơn giản hoá để loại bỏ các điểm thừa, ví dụ như chuyển các điểm đồng tuyến liên tiếp thành một đoạn đường duy nhất.

công khai trừu tượng boolean isGuidanceRunning ()

Trả về true nếu hướng dẫn hiện đang chạy. Xin lưu ý rằng hướng dẫn sẽ chỉ chạy sau khi tuyến đường tới một đích đến đã được tính toán và startGuidance() được gọi.

công khai trừu tượng khoảng trống setArrivalListener (Navigator.ArrivalListener)

Đăng ký một trình nghe sự kiện đến. Ghi đè mọi trình nghe đã đăng ký trước đó.

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

Các tham số

trình nghe	trình nghe để đăng ký. Bạn có thể thiết lập thành `null` để xoá trình nghe đã đăng ký trước đó.

công khai trừu tượng khoảng trống setAudioGuidance (hướng dẫn int)

Đặt loại hướng dẫn bằng âm thanh (bao gồm cả rung) được bật. Theo mặc định, các tính năng rung, giọng nói và giọng nói qua Bluetooth (nếu có) sẽ được bật.

Phương thức này phải được gọi trên luồng giao diện người dùng.

Các tham số

hướng dẫn	tổ hợp các cờ `Navigator.AudioGuidance` để xác định loại hướng dẫn bằng âm thanh nên được bật

công khai trừu tượng ListenableResultFuture<Navigator.RouteStatus> setDestination (Destinationpoint đích, RoutingOptions khuyênOptions, DisplayOptions displayOptions)

Các tham số

tài khoản đích	điểm đến mới cần thiết lập
routingOptions	các tuỳ chọn dùng để tạo tuyến đường
displayOptions	các tuỳ chọn dùng để hiện tuyến đường

Trả bóng

tương lai trả về

Gửi

NullPointerException	nếu đích đã cho là rỗng

công khai trừu tượng ListenableResultFuture<Navigator.RouteStatus> setDestination (Destinationpoint đích, RoutingOptions tuỳ chọn)

Đặt một đích đến duy nhất cho hoạt động điều hướng, ghi đè mọi đích đến đã đặt trước đó. Tương lai được trả về sẽ được đặt thành OK nếu tìm thấy một tuyến đường từ vị trí của người dùng tới đích đến nhất định. DisplayOptions mặc định sẽ được dùng để hiển thị tuyến đường.

Các tham số

tài khoản đích	điểm đến mới cần thiết lập
tùy chọn	các tuỳ chọn dùng để tạo tuyến đường

Trả bóng

tương lai trả về

Gửi

NullPointerException	nếu đích đã cho là rỗng

công khai trừu tượng ListenableResultFuture<Navigator.RouteStatus> setDestination (Đích đến)

Đặt một đích đến duy nhất cho hoạt động điều hướng, ghi đè mọi đích đến đã đặt trước đó. Tương lai được trả về sẽ được đặt thành OK nếu tìm thấy một tuyến đường từ vị trí của người dùng tới đích đến nhất định. RoutingOptions mặc định sẽ được dùng để tìm tuyến và DisplayOptions mặc định sẽ được dùng để hiển thị tuyến này.

Các tham số

tài khoản đích	điểm đến mới cần thiết lập

Trả bóng

tương lai trả về

Gửi

NullPointerException	nếu đích đã cho là rỗng

công khai trừu tượng ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> đích, RoutingOptions tuỳ chọn)

Đặt nhiều đích đến để điều hướng, ghi đè mọi đích đến đã đặt trước đó. Tương lai được trả về sẽ được đặt thành OK nếu tìm thấy một tuyến đường từ vị trí của người dùng tới đích đến nhất định. DisplayOptions mặc định sẽ được dùng để hiển thị tuyến đường.

Các tham số

đích đến	danh sách điểm đến mới cần thiết lập
tùy chọn	các tuỳ chọn dùng để tạo tuyến đường

Trả bóng

tương lai trả về

công khai trừu tượng ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> đích, RoutingOptions4}routeOptions, DisplayOptions displayOptions)

Các tham số

đích đến	danh sách điểm đến mới cần thiết lập
routingOptions	các tuỳ chọn dùng để tạo tuyến đường
displayOptions	các tuỳ chọn dùng để hiện tuyến đường

Trả bóng

tương lai trả về

công khai trừu tượng ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> đích)

Đặt nhiều đích đến để điều hướng, ghi đè mọi đích đến đã đặt trước đó. Tương lai được trả về sẽ được đặt thành OK nếu tìm thấy một tuyến đường từ vị trí của người dùng tới đích đến nhất định. RoutingOptions mặc định sẽ được dùng để tìm tuyến và DisplayOptions mặc định sẽ được dùng để hiển thị tuyến này.

Các tham số

đích đến	danh sách điểm đến mới cần thiết lập

Trả bóng

tương lai trả về

công khai bản tóm tắt void setHeadsUpNotificationEnabled (boolean enabled)

Đặt có hiển thị thông báo quan trọng hay không. Thông báo được bật theo mặc định. Sự kiện quan trọng là các sự kiện hướng dẫn (như ngã rẽ, v.v.) hiển thị khi không có bản đồ nào hiển thị.

Phương thức này phải được gọi trên luồng giao diện người dùng.

Các tham số

đang bật	một cờ để cho biết có nên bật thông báo quan trọng hay không

công khai trừu tượng khoảng trống setLicensePlateRestrictionInfo (int RAWLicensePlateLastDigit, String LicensePlateCountryCode)

Đặt thông tin biển số xe của người lái xe hiện tại. Việc này cho phép chúng tôi xác định tuyến đường đi xung quanh một số loại quy định hạn chế đường bộ dựa trên biển số xe. Giá trị này chỉ áp dụng cho các lệnh gọi setDestination được thực hiện sau khi bạn đặt giá trị này. Tốt nhất bạn nên gọi lệnh này ngay sau khi tải trình điều hướng.

Các tham số

rawLicensePlateLastDigit	Số cuối cùng của biển số xe (phải trong khoảng từ 0 đến 9).
licensePlateCountryCode	Hiện tại, chúng tôi đang hỗ trợ ở Indonesia (ID) và Brazil (BZ) có thể sẽ hỗ trợ cả những quốc gia khác trong tương lai. Do đó, bạn có thể chủ động cung cấp thông tin này.

công khai trừu tượng khoảng trống setRemainingTimeOrDistanceChangedListener (int timeChangethresholdSeconds, int distanceChangeThresholdMeters, trình nghe Navigator.RemainingTimeOrDistanceChangedListener)

Đăng ký trình nghe khi thời gian hoặc khoảng cách còn lại tới đích đến thay đổi nhiều hơn một ngưỡng đã chỉ định. Ghi đè mọi trình nghe đã đăng ký trước đó.

Trình nghe này có thể được gọi do (ví dụ:) chuyển động của người dùng, thay đổi điều kiện giao thông, thay đổi tuyến đường, thay đổi điểm đến hoặc khi đã biết thời gian và quãng đường còn lại.

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

Các tham số

timeChangeThresholdSeconds	Nếu mức thay đổi tuyệt đối trong thời gian còn lại tính bằng giây lớn hơn hoặc bằng giá trị này, thì trình nghe sẽ được gọi. Ngưỡng này không được là số âm.
distanceChangeThresholdMeters	Nếu sự thay đổi tuyệt đối trong khoảng cách còn lại tính bằng mét lớn hơn hoặc bằng giá trị này, thì trình nghe sẽ được gọi. Ngưỡng này không được là số âm.
trình nghe	trình nghe để đăng ký. Không được là `null`.

public abstract void setRouteChangedListener (Navigator.RouteChangedListener)

Đăng ký một trình nghe cho các sự kiện thay đổi tuyến đường. Ghi đè mọi trình nghe đã đăng ký trước đó.

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

Các tham số

trình nghe	trình nghe để đăng ký. Bạn có thể thiết lập thành `null` để xoá trình nghe đã đăng ký trước đó.

public abstract void setSpeedingListener (SpeedingListener speedingListener)

Đăng ký SpeedingListener cho tỷ lệ phần trăm vượt quá giới hạn tốc độ mà người lái xe hiện đang lái.

Khi đặt null SpeedingListener hoặc không đặt giá trị nào, bạn sẽ không nhận được dữ liệu tăng tốc của nguồn cấp dữ liệu.

Các tham số

speedingListener

công khai bản tóm tắt void startGuidance (Intent Intent)

Giống như startGuidance(), nhưng chỉ định một ý định có thể dùng để tiếp tục ứng dụng từ thông báo trên thanh trạng thái của trình điều hướng. Nếu không có ý định này, thì bạn không thể tiếp tục ứng dụng từ thanh trạng thái.

Các tham số

resumeIntent	ý định tiếp tục ứng dụng. Trong hầu hết các trường hợp, giá trị mà `android.app.Activity#getIntent()` trả về là phù hợp.

công khai trừu tượng khoảng trống startGuidance ()

Nếu đã đặt một đích đến và tính toán tuyến đường cho vị trí đó, thì hệ thống sẽ bắt đầu hướng dẫn chỉ đường từng chặng cho tuyến đường đó. Nếu một tuyến đường chưa được tính toán, hướng dẫn từng chặng sẽ bắt đầu khi đã được tính toán.

Bạn phải gọi startGuide() một cách rõ ràng để ngừng dịch vụ chỉ đường. Dịch vụ chỉ đường sẽ không tự động dừng khi đến nơi. Nếu muốn dừng dịch vụ chỉ đường khi đến nơi, bạn cần gọi startGuide() trong NavđếnListener.

Lưu ý: phương thức này không thay đổi vị trí của Camera.

công khai trừu tượng khoảng trống stopGuidance ()

Dừng hướng dẫn chỉ đường từng chặng.