Navigasyon API'sı

herkese açık final sınıfı NavigationApi Nesneyi genişletir

Gezinme API'sine giriş noktası. Navigator referansı almak için bu sınıftaki statik yöntemleri kullanın.

İç İçe geçmiş Sınıf Özeti

@arayüzü NavigationApi.ErrorCode Hata Kodu, Navigator başarıyla alınamadıysa getNavigator(Activity, NavigatorListener) ve getNavigator(Application, NavigatorListener) tarafından döndürülen bir durum kodudur. 
arayüz NavigationApi.NavigatorListener Söz konusu Navigator öğesinin durumu hakkında bildirim almak için getNavigator(Activity, NavigatorListener) hizmetine NavigatorListener kaydedin. 
arayüz NavigationApi.OnTermsResponseListener Kullanıcılar, hükümler ve koşulları kabul ettiğinde veya reddettiğinde bildirim almak için showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) ile bir OnTermsResponseListener kaydedin. 

Herkese Açık Yöntem Özeti

statik boole
areTermsAccepted(Başvuru başvurusu)
Kullanıcı daha önce Google'ın Gezinme şartları ve koşullarını kabul ettiyse true değerini döndürür.
statik geçersiz
cleanup()
NavSDK bileşenlerinin dahili durumunu temizler.
senkronize edildi statik ForegroundServiceManager
getForegroundServiceManager(Uygulama uygulaması)
Tekil ForegroundServiceManager örneğini elde eder.
static Dize
getNavSDKVersion()
Geçerli NavSDK sürümünü döndürür.
statik geçersiz
getNavigator(Uygulama uygulaması, NavigationApi.NavigatorListener geri çağırması)
Navigator örneğini elde eder.
statik geçersiz
getNavigator(Activity etkinliği, NavigationApi.NavigatorListener geri çağırması, TermsAndConditionsCheckOption termsCheck)
Navigator örneğini elde eder.
statik geçersiz
getNavigator(Etkinlik etkinliği, NavigationApi.NavigatorListener geri çağırması)
getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED} etiketine eş değer.
statik geçersiz
getNavigatorNoToS(Uygulama uygulaması, NavigationApi.NavigatorListener geri çağırması)
Navigator örneğini elde eder.
static RoadSnappedLocationProvider
getRoadSnappedLocationProvider(Uygulama uygulaması)
Yola müdahale eden kullanıcı konumlarına abone olmak için kullanılabilecek RoadSnappedLocationProvider örneğini elde eder.
static NavigationTransactionRecorder
getTransactionRecorder(Uygulama uygulaması)
Gezinmeyle ilgili işlemleri kaydetmek için kullanılabilecek NavigationTransactionRecorder örneğini alır.
senkronize edildi statik geçersiz
initForegroundServiceManager(Uygulama uygulaması, Tamsayı bildirimId, Dize defaultMessage, NotificationContentProvider sağlayıcısı)
ForegroundServiceManager örneğini, sağlanan bağımsız değişkenlerle başlatır.
statik geçersiz
resetTermsAccepted(Başvuru uygulaması)
Test için şartlar ve koşulları sıfırlayın.
statik geçersiz
showTermsAndConditionsDialog(Activity activity, String companyName, Dize başlığı, NavigationApi.OnTermsResponseListener işleyicisi)
Varsayılan görünümü kullanarak kullanıcıyı Google'ın Navigasyon şartlarını ve koşullarını kabul etmeye yönlendiren bir iletişim kutusu görüntüler.
statik geçersiz
showTermsAndConditionsDialog(Activity activity, String companyName, D String title, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener işleyicisi, TermsAndConditionsCheckOption termsAndConditionsCheckOption)
Kullanıcıyı, Google'ın Navigasyon şartlarını ve koşullarını kabul etmeye yönlendiren bir iletişim kutusu görüntüler.
statik geçersiz
showTermsAndConditionsDialog(Activity activity, String companyName, NavigationApi.OnTermsResponseListener işleyicisi)
Varsayılan başlığı, varsayılan görünümü ve tarzı kullanarak kullanıcıyı Google'ın Navigasyon şartlar ve koşullarını kabul etmeye yönlendiren bir iletişim kutusu görüntüler.

Devralınan Yöntem Özeti

Herkese Açık Yöntemler

herkese açık static boole areTermsAccepted (Uygulama uygulaması)

Kullanıcı daha önce Google'ın Gezinme şartları ve koşullarını kabul ettiyse true değerini döndürür.

Şartlar ekranını, kullanıcı bir yere gitmek üzereyken değil, uygulamanın başlarında görüntülemeniz gerekip gerekmediğini kontrol etmek için bunu kullanabilirsiniz. Örneğin, uygulamanız başka hükümler ve koşullar gösterirken bu değeri kontrol etmek uygun olabilir. Böylece, kullanıcı tek bir görevde uygulamayla ilgili gerekli tüm şart ve koşulları kabul edebilir.

Parametreler
uygulama mevcut uygulama
İlerlemeler
  • Şartlar kullanıcı tarafından kabul edildiyse true, aksi takdirde false

herkese açık statik void cleanup ()

NavSDK bileşenlerinin dahili durumunu temizler. Mevcut bir gezgin varsa yardım durdurulur ve devre dışı bırakılır. Bu Gezginden gelecekte yardım çağrısı yapılamaz. Uygulamanız artık Navigator'a ihtiyaç duymadığında ve Navigator'a ilişkin tüm referansları kaldırdığında belleği kurtarmak için bu yöntemi çağırın. Uygulamanız bu çağrıdan sonra bir Navigator gerektiriyorsa yeni bir tane oluşturmak için getNavigator() işlevini kullanın. Not: Yeni bir Gezgin oluşturmak zaman alır. Gecikme süresinin, uygulamanızın performansını kurtaran belleğin avantajlarına kıyasla nasıl etkileyeceğini değerlendirin.

herkese açık statik senkronize edildi ForegroundServiceManager getForegroundServiceManager (Uygulama uygulaması)

Tekil ForegroundServiceManager örneğini elde eder. initForegroundServiceManager(Application, Integer, String, NotificationContentProvider), getForegroundServiceManager(Application) tarihinden önce çağrılmazsa varsayılan bildirim kimliği, mesaj ve bildirim sağlayıcısı kullanılır.

Parametreler
uygulama şu anki Application

genel statik Dize getNavSDKVersion ()

Geçerli NavSDK sürümünü döndürür.

herkese açık static void getNavigator (Uygulama uygulaması, NavigationApi.NavigatorListener geri çağırması)

Navigator örneğini elde eder.

Kullanıcı henüz şartlar ve koşulları kabul etmediyse geri arama hemen TERMS_NOT_ACCEPTED hata koduyla etkinleşir.

Gezgin'in bir tekil olduğunu unutmayın. Bu yöntemi birden çok kez çağırırsanız her çağrı aynı Gezgin'i döndürür.

Parametreler
uygulama şu anki Application
geri çağırma Navigator hazır olduğunda tetiklenecek bir geri çağırma veya bir hata oluşur

herkese açık static void getNavigator (Activity activity, NavigationApi.NavigatorListener geri çağırması, TermsAndConditionsCheckOption termsCheck)

Navigator örneğini elde eder.

Kullanıcı henüz şartlar ve koşulları kabul etmediyse bu çağrıda, kullanıcıyı yerel düzenlemelere uymaya teşvik eden bir iletişim kutusu gösterilir.

termsCheck değeri ENABLED ise iletişim kutusunda Gezinme SDK'si Hükümler ve Koşulları'nın bağlantısı da bulunur. Kullanıcı bu şartları kabul etmezse callback, TERMS_NOT_ACCEPTED hatasıyla çağrılır.

Gezgin'in bir tekil olduğunu unutmayın. Bu yöntemi birden çok kez çağırırsanız her çağrı aynı Gezgin'i döndürür.

Parametreler
etkinlik Henüz kabul edilmediyse şartlar ve koşullar iletişim kutusunun gösterilmesi için Activity
geri çağırma Navigator hazır olduğunda tetiklenecek bir geri çağırma veya bir hata oluşur
termsCheck Hükümler ve Koşullar kontrolünün atlanıp atlanmayacağını belirtir

herkese açık static void getNavigator (Etkinlik etkinliği, NavigationApi.NavigatorListener geri çağırması)

getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED} etiketine eş değer.

Parametreler
etkinlik
geri çağırma

herkese açık static void getNavigatorNoToS (Uygulama uygulaması, NavigationApi.NavigatorListener geri çağırması)

Navigator örneğini elde eder.

Hükümler ve koşullar atlanır.

Gezgin'in bir tekil olduğunu unutmayın. Bu yöntemi birden çok kez çağırırsanız her çağrı aynı Gezgin'i döndürür.

Parametreler
uygulama mevcut Application.
geri çağırma Navigator hazır olduğunda tetiklenecek bir geri çağırma veya bir hata oluşur.

herkese açık statik RoadSnappedLocationProvider getRoadSnappedLocationProvider (Uygulama uygulaması)

Yola müdahale eden kullanıcı konumlarına abone olmak için kullanılabilecek RoadSnappedLocationProvider örneğini elde eder. Yolda kayıtlı konum güncellemelerine abone olmanın, pilin bitmesine veya arka planda çalışır durumda bırakılması halinde kullanıcı konum verilerinin yanlışlıkla toplanmasına neden olabileceğini unutmayın.

Bu yöntem çağrılmadan önce bir Navigator başarılı bir şekilde elde edilmelidir. Aksi takdirde, null döndürülür.

Parametreler
uygulama şu anki Application

herkese açık statik NavigationTransactionRecorder getTransactionRecorder (Uygulama uygulaması)

Gezinmeyle ilgili işlemleri kaydetmek için kullanılabilecek NavigationTransactionRecorder örneğini alır.

Bu sınıf, yalnızca şirketiniz Google tarafından işlem başına faturalandırılıyorsa kullanılmalıdır.

Bu yöntem çağrılmadan önce bir Navigator başarılı bir şekilde elde edilmelidir. Aksi takdirde, null döndürülür.

Parametreler
uygulama şu anki Application

herkese açık statik senkronize void initForegroundServiceManager (Application application, Integer notificationId, String defaultMessage, NotificationContentProvider sağlayıcısı)

ForegroundServiceManager örneğini, sağlanan bağımsız değişkenlerle başlatır.

Bu, yalnızca varsayılan parametrelerden herhangi birini değiştirmek istediğinizde çağrılmalıdır. Aksi halde doğrudan getForegroundServiceManager(Application) numaralı telefonu arayın. Bu yöntem yalnızca bir kez çağrılabilir ve getForegroundServiceManager(Application) tarihinden önce çağrılmalıdır.

Parametreler
uygulama şu anki Application
notificationId kalıcı bildirimin bildirim kimliği
defaultMessage provider belirtilmezse gösterilecek varsayılan mesaj
sağlayıcı NotificationContentProvider özelliğinin uygulanması

herkese açık static void resetTermsAccepted (Uygulama uygulaması)

Test için şartlar ve koşulları sıfırlayın. Hükümler ve koşullar iletişim kutusunu test etmek istiyorsanız NavigationApi öğesine yapılan herhangi bir çağrıdan önce buna bir çağrı ekleyin.

Parametreler
uygulama mevcut uygulama

herkese açık static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, NavigationApi.OnTermsResponseListener işleyicisi)

Varsayılan görünümü kullanarak kullanıcıyı Google'ın Navigasyon şartlarını ve koşullarını kabul etmeye yönlendiren bir iletişim kutusu görüntüler.

Parametreler
etkinlik
companyName
başlık
işleyici

herkese açık static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener işleyicisi, TermsAndConditionsCheckOption termsAndConditionsOption)

Kullanıcıyı, Google'ın Navigasyon şartlarını ve koşullarını kabul etmeye yönlendiren bir iletişim kutusu görüntüler. Belirtilirse dinleyici, kullanıcı arayüzü iş parçacığında çağrılır ve kullanıcının şartlar ve koşulları kabul edip etmediğini gösterir.

Kullanıcı daha önce kabul etmiş olsa bile iletişim kutusunun gösterileceğini unutmayın. Bu, yalnızca areTermsAccepted(Application) false ise çağrılmalıdır çünkü kullanıcının şartlar ve koşulları kabul etmesini iptal etmesi mümkün değildir.

Parametreler
etkinlik iletişimin gösterileceği Activity
companyName şirketinizin adı (şartlar ve koşullar iletişim kutusunda görüntülenir)
başlık iletişim kutusunun başlığı. Değer boşsa iletişim kutusunda varsayılan başlık kullanılır.
uiParams iletişim kutusunun görünümünü ve tarzını özelleştirmek için kullanılan parametreler. Null ise varsayılan görünüm ve tarz kullanılır.
işleyici kullanıcı şartlar ve koşulları kabul ettiğinde veya reddettiğinde tetiklenen isteğe bağlı bir geri arama
termsAndConditionsCheckOption Hükümler ve koşulları kontrol etme seçeneklerini belirten TermsAndConditionsCheckOption

herkese açık static void showTermsAndConditionsDialog (Activity activity, String companyName, NavigationApi.OnTermsResponseListener işleyicisi)

Varsayılan başlığı, varsayılan görünümü ve tarzı kullanarak kullanıcıyı Google'ın Navigasyon şartlar ve koşullarını kabul etmeye yönlendiren bir iletişim kutusu görüntüler.

Parametreler
etkinlik
companyName
işleyici