Navigator

antarmuka publik Navigator

singleton yang menyediakan metode untuk mengontrol navigasi.

Semua metode dijamin aman untuk thread, kecuali untuk setAudioGuidelines dan setHeadsUpNotificationEnabled yang harus dipanggil di UI thread.

Ringkasan Class Bertingkat

antarmuka	Navigator.ArrivalListener		Menentukan tanda tangan untuk metode yang dipanggil saat pengemudi tiba di titik jalan.
@antarmuka	Navigator.AudioGuidance		AudioPanduan adalah serangkaian tanda yang digunakan untuk menentukan jenis peringatan dan panduan audio yang digunakan selama navigasi.
antarmuka	Navigator.RemainingTimeOrDistanceChangedListener		Menentukan tanda tangan untuk metode yang dipanggil saat waktu atau jarak yang tersisa ke tujuan berikutnya berubah.
antarmuka	Navigator.RouteChangedListener		Menentukan tanda tangan untuk metode yang dipanggil saat rute berubah.
enum	Navigator.RouteStatus		RouteStatus adalah kode status yang mewakili hasil penghitungan rute, yang diakses melalui Future yang ditampilkan oleh setDestination(Waypoint).

Ringkasan Metode Publik

abstrak void	pembersihan() Membersihkan status internal Navigator.
abstrak void	clearDestinations() Menghapus semua tujuan yang ditetapkan sebelumnya dan menghapus semua rute yang dihitung dari peta.
abstrak void	clearLicensePlateRestrictionInfo() Menghapus informasi pelat nomor tentang pengemudi saat ini.
abstrak void	clearRemainingTimeOrDistanceChangedListener() Menghapus pemroses untuk mengetahui perubahan dalam waktu atau jarak yang tersisa.
abstrak Waypoint	continueToNextDestination() Menghapus tujuan saat ini.
abstrak ListenableResultFuture<RouteInfo>	fetchRouteInfo(titik jalan Waypoint, RoutingOptions routingOptions) Menampilkan informasi rute untuk rute berdasarkan setiap nilai RoutingOptions.RoutingStrategy.
abstrak RouteSegment	getCurrentRouteSegment() Menampilkan segmen perjalanan saat ini.
abstrak TimeAndDistance	getCurrentTimeAndDistance() Menampilkan perkiraan waktu dan jarak dari posisi saat ini ke tujuan saat ini.
abstrak Daftar<RouteSegment>	getRouteSegments() Menampilkan daftar segmen rute.
abstrak Simulator	getSimulator() Menampilkan objek Simulator, untuk digunakan selama pengujian.
abstrak Daftar<TimeAndDistance>	getTimeAndDistanceList() Menampilkan daftar waktu dan jarak yang sesuai dengan setiap tujuan dalam rute saat ini, yang merepresentasikan perkiraan waktu dan jarak dari posisi saat ini ke setiap tujuan.
abstrak Daftar<LatLng>	getTraveledRoute() Menampilkan rute yang ditempuh sejauh ini selama sesi panduan ini (sejak panggilan terakhir ke startGuidance()).
abstrak boolean	isGuidanceRunning() Menampilkan true jika panduan sedang berjalan.
abstrak void	setArrivalListener(pemroses Navigator.ArrivalListener) Mendaftarkan pemroses untuk peristiwa kedatangan.
abstrak void	setAudioGuidance(panduan int) Menyetel jenis panduan audio (termasuk getaran) yang diaktifkan.
abstrak ListenableResultFuture<Navigator.RouteStatus>	setDestination(tujuan Waypoint, routingOptions RoutingOptions, DisplayOptions displayOptions) Menetapkan satu tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya.
abstrak ListenableResultFuture<Navigator.RouteStatus>	setDestination(tujuan Waypoint, opsi RoutingOptions) Menetapkan satu tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya.
abstrak ListenableResultFuture<Navigator.RouteStatus>	setDestination(tujuan Titik jalan) Menetapkan satu tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya.
abstrak ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Daftar tujuan<Waypoint>, opsi RoutingOptions) Menetapkan beberapa tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya.
abstrak ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint> tujuan, RoutingOptions routingOptions, DisplayOptions displayOptions) Menetapkan beberapa tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya.
abstrak ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Daftar tujuan<Waypoint>) Menetapkan beberapa tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya.
abstrak void	setHeadsUpNotificationEnabled(boolean diaktifkan) Menetapkan apakah notifikasi pendahuluan akan ditampilkan.
abstrak void	setLicensePlateRestrictionInfo(int rawLicensePlateLastDigit, String LicensePlateCountryCode) Menyetel informasi pelat nomor tentang pengemudi saat ini.
abstrak void	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, int distanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener) Mendaftarkan pemroses saat waktu atau jarak yang tersisa ke tujuan berubah lebih dari nilai minimum yang ditentukan.
abstrak void	setRouteChangedListener(pemroses Navigator.RouteChangedListener)) Mendaftarkan pemroses untuk peristiwa rute yang diubah.
abstrak void	setSpeedingListener(SpeedingListener speedingListener) Mendaftarkan SpeedingListener untuk persentase di atas batas kecepatan yang saat ini dilalui pengemudi.
abstrak void	startGuidance(Intent resumeIntent) Sama seperti startGuidance(), tetapi menentukan intent yang dapat digunakan untuk melanjutkan aplikasi dari notifikasi status bar navigator.
abstrak void	startGuidance() Jika tujuan telah ditetapkan dan rute dihitung untuk tujuan tersebut, memulai panduan navigasi belokan demi belokan untuk rute tersebut.
abstrak void	stopGuidance() Menghentikan panduan navigasi belokan demi belokan.

Metode Publik

public abstrak void pembersihan ()

Membersihkan status internal Navigator.

Catatan: memanggil metode ini akan membatalkan semua permintaan yang tertunda ke setDestinations(List).

public abstrak void clearDestinations ()

Menghapus semua tujuan yang ditetapkan sebelumnya dan menghapus semua rute yang dihitung dari peta. Jika navigasi sedang berjalan, navigasi akan otomatis menghentikannya.

public abstract void clearLicensePlateRestrictionInfo ()

Menghapus informasi pelat nomor tentang pengemudi saat ini. Ini hanya akan berlaku untuk panggilan setDestination yang dilakukan setelah nilai ini ditetapkan.

public abstrak void clearRemainingTimeOrDistanceChangedListener ()

Menghapus pemroses untuk mengetahui perubahan dalam waktu atau jarak yang tersisa.

public abstrak Waypoint continueToNextDestination ()

Menghapus tujuan saat ini. Setelah panggilan ini, panduan akan mengarah ke tujuan berikutnya, dan informasi tentang tujuan lama tidak tersedia.

Hasil

• panduan titik jalan sekarang menuju ke, atau null jika tidak ada lagi titik jalan yang tersisa

public abstrak ListenableResultFuture<RouteInfo> fetchRouteInfo (Waypoint titik jalan, RoutingOptions routingOptions)

Menampilkan informasi rute untuk rute berdasarkan setiap nilai RoutingOptions.RoutingStrategy. RoutingOptions.RoutingStrategy diabaikan karena metode ini menampilkan informasi rute untuk semua strategi pemilihan rute.

Catatan: Jumlah ini dihitung ulang pada setiap panggilan dan mungkin tidak cocok dengan rute yang saat ini digunakan oleh navigasi karena lalu lintas dan faktor lainnya mungkin telah diperbarui untuk sementara.

Parameter

titik jalan	titik jalan tujuan untuk rute
routingOptions	opsi yang digunakan untuk mengambil info rute

Hasil

• masa depan yang ditampilkan

public abstrak RouteSegment getCurrentRouteSegment ()

Menampilkan segmen perjalanan saat ini. RouteSegment ini akan memiliki posisi awal sebagai posisi terbaru perangkat yang diketahui (dipasok jalan).

Hasil

• objek segmen rute, atau null jika tidak ada rute saat ini

public abstrak TimeAndDistance getCurrentTimeAndDistance ()

Menampilkan perkiraan waktu dan jarak dari posisi saat ini ke tujuan saat ini.

Hasil

• objek waktu dan jarak, atau null jika tidak ada rute saat ini

public abstrak List<RouteSegment> getRouteSegments ()

Menampilkan daftar segmen rute. Tujuan setiap segmen yang ditampilkan akan sesuai dengan tujuan yang ditetapkan oleh setDestination.

public abstrak Simulator getSimulator ()

Menampilkan objek Simulator, untuk digunakan selama pengujian.

public abstrak List<TimeAndDistance> getTimeAndDistanceList ()

Menampilkan daftar waktu dan jarak yang sesuai dengan setiap tujuan dalam rute saat ini, yang merepresentasikan perkiraan waktu dan jarak dari posisi saat ini ke setiap tujuan.

public abstrak List<LatLng> getTraveledRoute ()

Menampilkan rute yang telah ditempuh sejauh ini selama sesi panduan ini (sejak panggilan terakhir ke startGuidance()). Rute yang direkam terdiri dari lokasi jalan yang diikat seperti yang akan ditampilkan oleh RoadSnappedLocationProvider, dan disederhanakan untuk menghapus titik-titik yang berlebihan, misalnya mengubah titik kolinear yang berurutan menjadi satu segmen garis.

public abstrak boolean isGuidanceRunning ()

Menampilkan true jika panduan sedang berjalan. Perhatikan bahwa panduan hanya akan berjalan setelah rute ke tujuan dihitung dan startGuidance() telah dipanggil.

public abstract void setArrivalListener (Navigator.ArrivalListener)

Mendaftarkan pemroses untuk peristiwa kedatangan. Mengganti pemroses yang terdaftar sebelumnya.

Catatan: Untuk menghindari kebocoran memori, setNavArrivalListener(null) harus dipanggil saat pemroses tidak lagi diperlukan.

Parameter

pemroses	pemroses untuk didaftarkan. Dapat ditetapkan ke null untuk menghapus pemroses yang telah terdaftar.

public abstrak void setAudioGuidance (int Guidelines)

Menyetel jenis panduan audio (termasuk getaran) yang diaktifkan. Secara default, getaran, suara, dan suara melalui Bluetooth (jika tersedia) diaktifkan.

Metode ini harus dipanggil di UI thread.

Parameter

panduan	kombinasi flag Navigator.AudioGuidance yang menentukan jenis panduan audio yang harus diaktifkan

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint tujuan, RoutingOptions routingOptions, DisplayOptions displayOptions)

Menetapkan satu tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya. Masa depan yang ditampilkan akan ditetapkan ke OK jika rute ditemukan dari lokasi pengguna ke tujuan yang ditentukan.

Parameter

akun penerima	tujuan baru untuk ditetapkan
routingOptions	opsi yang akan digunakan untuk menghasilkan rute
displayOptions	opsi yang akan digunakan untuk menampilkan rute

Hasil

• masa depan yang ditampilkan

Menampilkan

NullPointerException	jika tujuan yang diberikan adalah null

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint tujuan, RoutingOptions opsi)

Menetapkan satu tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya. Masa depan yang ditampilkan akan ditetapkan ke OK jika rute ditemukan dari lokasi pengguna ke tujuan yang ditentukan. DisplayOptions default akan digunakan untuk menampilkan rute.

Parameter

akun penerima	tujuan baru untuk ditetapkan
opsi	opsi yang akan digunakan untuk menghasilkan rute

Hasil

• masa depan yang ditampilkan

Menampilkan

NullPointerException	jika tujuan yang diberikan adalah null

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint tujuan)

Menetapkan satu tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya. Masa depan yang ditampilkan akan ditetapkan ke OK jika rute ditemukan dari lokasi pengguna ke tujuan yang ditentukan. RoutingOptions default akan digunakan untuk menemukan rute, dan DisplayOptions default akan digunakan untuk menampilkannya.

Parameter

akun penerima	tujuan baru untuk ditetapkan

Hasil

• masa depan yang ditampilkan

Menampilkan

NullPointerException	jika tujuan yang diberikan adalah null

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> tujuan, RoutingOptions opsi)

Menetapkan beberapa tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya. Masa depan yang ditampilkan akan ditetapkan ke OK jika rute ditemukan dari lokasi pengguna ke tujuan yang ditentukan. DisplayOptions default akan digunakan untuk menampilkan rute.

Parameter

tujuan	daftar tujuan baru untuk ditetapkan
opsi	opsi yang akan digunakan untuk menghasilkan rute

Hasil

• masa depan yang ditampilkan

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> tujuan, RoutingOptions routingOptions, DisplayOptions displayOptions)

Menetapkan beberapa tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya. Masa depan yang ditampilkan akan ditetapkan ke OK jika rute ditemukan dari lokasi pengguna ke tujuan yang ditentukan.

Parameter

tujuan	daftar tujuan baru untuk ditetapkan
routingOptions	opsi yang akan digunakan untuk menghasilkan rute
displayOptions	opsi yang akan digunakan untuk menampilkan rute

Hasil

• masa depan yang ditampilkan

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (Daftar<Waypoint> tujuan)

Menetapkan beberapa tujuan untuk navigasi, menggantikan tujuan yang ditetapkan sebelumnya. Masa depan yang ditampilkan akan ditetapkan ke OK jika rute ditemukan dari lokasi pengguna ke tujuan yang ditentukan. RoutingOptions default akan digunakan untuk menemukan rute, dan DisplayOptions default akan digunakan untuk menampilkannya.

Parameter

tujuan	daftar tujuan baru untuk ditetapkan

Hasil

• masa depan yang ditampilkan

public abstrak void setHeadsUpNotificationEnabled (boolean enabled)

Menetapkan apakah notifikasi pendahuluan akan ditampilkan. Secara default, notifikasi diaktifkan. Peristiwa peringatan adalah peristiwa panduan seperti belokan, dll., yang ditampilkan saat tidak ada peta yang terlihat.

Metode ini harus dipanggil di UI thread.

Parameter

diaktifkan	tanda untuk menunjukkan apakah notifikasi peringatan dini harus diaktifkan

public abstract void setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit, String LicensePlateCountryCode)

Menyetel informasi pelat nomor tentang pengemudi saat ini. Dengan begitu, kami dapat memilih rute tertentu untuk menghindari jenis pembatasan jalan tertentu yang didasarkan pada nomor pelat kendaraan. Ini hanya akan berlaku untuk panggilan setDestination yang dilakukan setelah nilai ini ditetapkan. Idealnya, Anda harus segera memanggilnya setelah mendapatkan navigator.

Parameter

rawLicensePlateLastDigit	Digit terakhir pelat nomor (harus antara 0 dan 9).
licensePlateCountryCode	Saat ini kami mendukung Indonesia (ID) dan Brasil (BZ) negara lainnya yang mungkin didukung di masa mendatang dan Anda bebas memberikan informasi ini secara proaktif.

public abstract void setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, int distanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener)

Mendaftarkan pemroses saat waktu atau jarak yang tersisa ke tujuan berubah lebih dari nilai minimum yang ditentukan. Mengganti pemroses yang terdaftar sebelumnya.

Pemroses dapat dipanggil sebagai hasil dari (misalnya) pergerakan pengguna, perubahan kondisi lalu lintas, perubahan rute, perubahan tujuan, atau saat waktu dan jarak yang tersisa pertama kali diketahui.

Catatan: Untuk menghindari kebocoran memori, clearNavProgressionListener() harus dipanggil saat pemroses tidak lagi diperlukan.

Parameter

timeChangeThresholdSeconds	Jika perubahan absolut dalam waktu yang tersisa dalam detik lebih besar dari atau sama dengan nilai ini, pemroses akan dipanggil. Ambang batas ini tidak boleh negatif.
distanceChangeThresholdMeters	Jika perubahan absolut dalam jarak yang tersisa dalam meter lebih besar dari atau sama dengan nilai ini, pemroses akan dipanggil. Ambang batas ini tidak boleh negatif.
pemroses	pemroses untuk didaftarkan. Tidak boleh null.

public abstract void setRouteChangedListener (Pemroses Navigator.RouteChangedListener)

Mendaftarkan pemroses untuk peristiwa rute yang diubah. Mengganti pemroses yang terdaftar sebelumnya.

Catatan: Untuk menghindari kebocoran memori, setNavRouteChangeListener(null) harus dipanggil saat pemroses tidak lagi diperlukan.

Parameter

pemroses	pemroses untuk didaftarkan. Dapat ditetapkan ke null untuk menghapus pemroses yang telah terdaftar.

public abstrak void setSpeedingListener (SpeedingListener speedingListener)

Mendaftarkan SpeedingListener untuk persentase di atas batas kecepatan yang saat ini dilalui pengemudi.

Jika null SpeedingListener disetel atau tidak disetel, Anda tidak akan menerima data feed yang mempercepat.

Parameter

speedingListener

public abstrak void startGuidance (Intent resumeIntent)

Sama seperti startGuidance(), tetapi menentukan intent yang dapat digunakan untuk melanjutkan aplikasi dari notifikasi status bar navigator. Tanpa intent ini, aplikasi tidak dapat dilanjutkan dari status bar.

Parameter

resumeIntent	intent untuk melanjutkan aplikasi. Pada umumnya, nilai yang ditampilkan oleh android.app.Activity#getIntent() akan cocok.

public abstrak void startGuidance ()

Jika tujuan telah ditetapkan dan rute dihitung untuk tujuan tersebut, memulai panduan navigasi belokan demi belokan untuk rute tersebut. Jika rute belum dihitung, panduan belokan demi belokan akan dimulai begitu sudah dimulai.

Anda harus secara eksplisit memanggil stopGuide() untuk menghentikan layanan navigasi. Layanan navigasi tidak akan berhenti secara otomatis saat kedatangan. Jika ingin menghentikan layanan navigasi setelah sampai, Anda harus memanggil stopGuide() di NavArrivalListener.

Catatan: metode ini tidak mengubah posisi Camera.

public abstrak void stopGuidance ()

Menghentikan panduan navigasi belokan demi belokan.