NavigasiApi

public final class NavigationApi memperluas Object

Titik entri ke Navigation API. Gunakan metode statis di class ini untuk mendapatkan referensi ke Navigator.

Ringkasan Class Bertingkat

@antarmuka	NavigationApi.ErrorCode		ErrorCode adalah kode status yang ditampilkan oleh getNavigator(Activity, NavigatorListener) dan getNavigator(Application, NavigatorListener) saat Navigator tidak berhasil diperoleh.
antarmuka	NavigationApi.NavigatorListener		Daftarkan NavigatorListener dengan getNavigator(Activity, NavigatorListener) agar menerima notifikasi tentang status Navigator tersebut.
antarmuka	NavigationApi.OnTermsResponseListener		Daftarkan OnTermsResponseListener ke showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) untuk menerima notifikasi saat pengguna menerima atau menolak persyaratan dan ketentuan.

Ringkasan Metode Publik

boolean statis	areTermsAccepted(Permohonan) Menampilkan true jika pengguna sebelumnya telah menyetujui persyaratan dan ketentuan Navigasi Google.
void statis	pembersihan() Membersihkan status internal komponen NavSDK.
disinkronkan statis ForegroundServiceManager	getForegroundServiceManager(Aplikasi aplikasi) Mendapatkan instance ForegroundServiceManager singleton.
string statis	getNavSDKVersion() Menampilkan versi NavSDK saat ini.
void statis	getNavigator(Aplikasi aplikasi, callback NavigationApi.NavigatorListener) Mendapatkan instance Navigator.
void statis	getNavigator(Aktivitas aktivitas, callback NavigationApi.NavigatorListener, TermsAndConditionsCheckOption termsCheck) Mendapatkan instance Navigator.
void statis	getNavigator(Aktivitas aktivitas, callback NavigationApi.NavigatorListener) Setara dengan getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.
void statis	getNavigatorNoToS(Aplikasi aplikasi, callback NavigationApi.NavigatorListener) Mendapatkan instance Navigator.
static RoadSnappedLocationProvider	getRoadSnappedLocationProvider(Aplikasi aplikasi) Memperoleh instance RoadSnappedLocationProvider, yang dapat digunakan untuk berlangganan ke lokasi pengguna yang di-snap.
NavigationTransactionRecorder statis	getTransactionRecorder(Aplikasi aplikasi) Memperoleh instance NavigationTransactionRecorder, yang dapat digunakan untuk mencatat transaksi yang terkait dengan navigasi.
disinkronkan statis void	initForegroundServiceManager(Aplikasi aplikasi, Integer notificationId, String defaultMessage, NotificationContentProvider) Menginisialisasi instance ForegroundServiceManager dengan argumen yang diberikan.
void statis	resetTermsAccepted(Aplikasi aplikasi) Reset persyaratan dan ketentuan - untuk pengujian.
void statis	showTermsAndConditionsDialog(Aktivitas aktivitas, String companyName, Judul string, pemroses NavigationApi.OnTermsResponseListener) Menampilkan dialog yang mengarahkan pengguna untuk menyetujui persyaratan dan ketentuan Navigasi Google, menggunakan tampilan dan nuansa default.
void statis	showTermsAndConditionsDialog(Aktivitas aktivitas, String companyName, Judul String, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener, TermsAndConditionsCheckOption termsAndConditionsCheckOption) Menampilkan dialog yang mengarahkan pengguna untuk menyetujui persyaratan dan ketentuan Navigasi Google.
void statis	showTermsAndConditionsDialog(Aktivitas aktivitas, String companyName, pemroses NavigationApi.OnTermsResponseListener) Menampilkan dialog yang mengarahkan pengguna untuk menyetujui persyaratan dan ketentuan Navigasi Google, menggunakan judul default serta tampilan dan nuansa default.

Ringkasan Metode Turunan

Dari class java.lang.Object

boolean	equals(Object arg0)
kelas akhir<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(panjang arg0)
final void	wait()

Metode Publik

public static boolean areTermsAccepted (Aplikasi aplikasi)

Menampilkan true jika pengguna sebelumnya telah menyetujui persyaratan dan ketentuan Navigasi Google.

Anda dapat menggunakannya untuk memeriksa apakah Anda harus menampilkan layar istilah di awal aplikasi, bukan saat pengguna akan menuju ke suatu tempat. Misalnya, mungkin perlu untuk memeriksa nilai ini saat aplikasi Anda menampilkan persyaratan dan ketentuan lain, sehingga pengguna dapat menyetujui semua persyaratan dan ketentuan yang diperlukan untuk aplikasi dalam satu tugas.

Parameter

aplikasi	aplikasi saat ini

Hasil

• true jika persyaratan telah disetujui oleh pengguna, dan false jika tidak

publik statis void pembersihan ()

Membersihkan status internal komponen NavSDK. Jika navigator saat ini ada, panduan akan dihentikan dan dinonaktifkan. Tidak ada lagi permintaan panduan yang dapat dilakukan dari Navigator ini. Panggil metode ini untuk memulihkan memori jika aplikasi tidak lagi memerlukan Navigator dan aplikasi Anda telah menghancurkan semua referensi ke Navigator. Jika aplikasi Anda memerlukan Navigator setelah panggilan ini, gunakan getNavigator() untuk membuat Navigator baru. Catatan: Membuat Navigator baru memerlukan waktu; pertimbangkan bagaimana penundaan akan memengaruhi performa aplikasi Anda dibandingkan dengan manfaat memori yang dipulihkan.

publik statis disinkronkan ForegroundServiceManager getForegroundServiceManager (Aplikasi aplikasi)

Mendapatkan instance ForegroundServiceManager singleton. Jika initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) tidak dipanggil sebelum getForegroundServiceManager(Application), ID notifikasi, pesan, dan penyedia notifikasi default akan digunakan.

Parameter

aplikasi	Application saat ini

publik statis String getNavSDKVersion ()

Menampilkan versi NavSDK saat ini.

public static void getNavigator (Application application, NavigationApi.NavigatorListener callback)

Mendapatkan instance Navigator.

Jika pengguna belum menyetujui persyaratan dan ketentuan, callback akan segera diaktifkan dengan kode error TERMS_NOT_ACCEPTED.

Perhatikan bahwa Navigator adalah singleton; jika Anda memanggil metode ini beberapa kali, setiap panggilan akan menampilkan Navigator yang sama.

Parameter

aplikasi	Application saat ini
callback	callback yang akan diaktifkan saat Navigator siap, atau terjadi error

publik statis void getNavigator (Aktivitas aktivitas, callback NavigationApi.NavigatorListener, TermsAndConditionsCheckOption termsCheck)

Mendapatkan instance Navigator.

Jika pengguna belum menyetujui persyaratan dan ketentuan, panggilan ini akan menampilkan dialog yang mendorong pengguna untuk mematuhi peraturan setempat.

Jika termsCheck adalah ENABLED, dialog juga akan berisi link ke Persyaratan dan Ketentuan untuk Navigation SDK. callback akan dipanggil dengan error TERMS_NOT_ACCEPTED jika pengguna gagal menyetujui persyaratan ini.

Perhatikan bahwa Navigator adalah singleton; jika Anda memanggil metode ini beberapa kali, setiap panggilan akan menampilkan Navigator yang sama.

Parameter

aktivitas	Activity untuk menampilkan dialog persyaratan dan ketentuan, jika belum disetujui
callback	callback yang akan diaktifkan saat Navigator siap, atau terjadi error
termsCheck	yang menunjukkan apakah pemeriksaan Persyaratan dan Ketentuan harus dilewati atau tidak

public static void getNavigator (Aktivitas aktivitas, callback NavigationApi.NavigatorListener)

Setara dengan getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.

Parameter

aktivitas
callback

Lihat Juga

• getNavigator(Activity, NavigatorListener, TermsAndConditionsCheckOption)

public static void getNavigatorNoToS (Application application, callback NavigationApi.NavigatorListener)

Mendapatkan instance Navigator.

Mengabaikan persyaratan dan ketentuan.

Perhatikan bahwa Navigator adalah singleton; jika Anda memanggil metode ini beberapa kali, setiap panggilan akan menampilkan Navigator yang sama.

Parameter

aplikasi	Application saat ini.
callback	callback yang akan diaktifkan saat Navigator siap, atau terjadi error.

public static RoadSnappedLocationProvider getRoadSnappedLocationProvider (Aplikasi aplikasi)

Memperoleh instance RoadSnappedLocationProvider, yang dapat digunakan untuk berlangganan ke lokasi pengguna yang di-snap. Perhatikan bahwa berlangganan update lokasi jalan dapat menyebabkan pengurasan baterai atau pengumpulan data lokasi pengguna yang tidak disengaja jika dibiarkan berjalan di latar belakang.

Navigator harus berhasil diperoleh sebelum memanggil metode ini. Jika tidak, metode ini akan menampilkan null.

Parameter

aplikasi	Application saat ini

public static NavigationTransactionRecorder getTransactionRecorder (Aplikasi aplikasi)

Memperoleh instance NavigationTransactionRecorder, yang dapat digunakan untuk mencatat transaksi yang terkait dengan navigasi.

Class ini sebaiknya digunakan jika dan hanya jika perusahaan Anda ditagih oleh Google dengan basis per transaksi.

Navigator harus berhasil diperoleh sebelum memanggil metode ini. Jika tidak, metode ini akan menampilkan null.

Parameter

aplikasi	Application saat ini

public static sync void initForegroundServiceManager (Application application, Integer notificationId, String defaultMessage, NotificationContentProvider provider)

Menginisialisasi instance ForegroundServiceManager dengan argumen yang diberikan.

Ini hanya boleh dipanggil jika Anda ingin memodifikasi salah satu parameter default. Jika tidak, panggil getForegroundServiceManager(Application) secara langsung. Metode ini hanya dapat dipanggil sekali dan harus dipanggil sebelum getForegroundServiceManager(Application).

Parameter

aplikasi	Application saat ini
notificationId	id notifikasi untuk notifikasi persisten
defaultMessage	pesan default yang akan ditampilkan jika provider tidak ditentukan
penyedia	implementasi dari NotificationContentProvider

public static void resetTermsAccepted (Permohonan aplikasi)

Reset persyaratan dan ketentuan - untuk pengujian. Tambahkan panggilan ke sini sebelum panggilan ke NavigationApi jika Anda ingin menguji dialog persyaratan dan ketentuan.

Parameter

aplikasi	aplikasi saat ini

public static void showTermsAndConditionsDialog (Aktivitas aktivitas, String companyName, String title, NavigationApi.OnTermsResponseListener)

Menampilkan dialog yang mengarahkan pengguna untuk menyetujui persyaratan dan ketentuan Navigasi Google, menggunakan tampilan dan nuansa default.

Parameter

aktivitas
companyName
title
pemroses

Lihat Juga

• for a description of the different parameters.

public static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener pemroses, TermsAndConditionsCheckOption termsAndConditionsCheckOption)

Menampilkan dialog yang mengarahkan pengguna untuk menyetujui persyaratan dan ketentuan Navigasi Google. Jika ditentukan, pemroses akan dipanggil pada UI thread, yang menunjukkan apakah pengguna menerima persyaratan dan ketentuan atau tidak.

Perhatikan bahwa dialog akan muncul meskipun pengguna telah menyetujui sebelumnya. Metode ini hanya boleh dipanggil jika areTermsAccepted(Application) adalah false, karena pengguna tidak dapat membatalkan persyaratan dan ketentuan tersebut.

Parameter

aktivitas	Activity tempat dialog akan ditampilkan
companyName	nama perusahaan Anda, yang akan ditampilkan di dialog persyaratan dan ketentuan
title	judul dialog. Jika null, dialog akan menggunakan judul default.
uiParams	parameter yang digunakan untuk menyesuaikan tampilan dan nuansa dialog. Jika null, tampilan dan nuansa default akan digunakan.
pemroses	callback opsional yang akan diaktifkan saat pengguna menerima atau menolak persyaratan dan ketentuan
termsAndConditionsCheckOption	TermsAndConditionsCheckOption yang menentukan opsi untuk memeriksa persyaratan dan ketentuan

public static void showTermsAndConditionsDialog (Activity activity, String companyName, NavigationApi.OnTermsResponseListener)

Menampilkan dialog yang mengarahkan pengguna untuk menyetujui persyaratan dan ketentuan Navigasi Google, menggunakan judul default serta tampilan dan nuansa default.

Parameter

aktivitas
companyName
pemroses

Lihat Juga

• for a description of the different parameters.