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
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, danfalse
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.
public static void getNavigator (Aktivitas aktivitas, callback NavigationApi.NavigatorListener)
Setara dengan getNavigator(activity, callback, {@link
TermsAndConditionsCheckOption#ENABLED}
.
Parameter
aktivitas | |
---|---|
callback |
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 |
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 |