Gezinmenin denetlenmesine ilişkin yöntemler sağlayan bir tekil.
Kullanıcı arayüzü iş parçacığında çağrılması gereken setAudioGuidance ve setHeadsUp NotificationEnabled dışındaki tüm yöntemlerin iş parçacığı açısından güvenli olduğu garanti edilir.
İç İçe geçmiş Sınıf Özeti
arayüz | Navigator.ArrivalListener | Sürücü bir ara noktaya vardığında çağrılan yöntemler için imzalar tanımlar. | |
@arayüzü | Navigator.AudioGuidance | AudioGuidance, navigasyon sırasında ne tür sesli uyarılar ve rehberlik kullanılacağını belirtmek için kullanılan bir dizi işarettir. | |
arayüz | Navigator.RemainingTimeOrDistanceChangedListener | Bir sonraki hedefe kalan süre veya mesafe değiştiğinde çağrılan yöntemler için imzalar tanımlar. | |
arayüz | Navigator.RouteChangedListener | Rota değiştiğinde çağrılan yöntemler için imzalar tanımlar. | |
enum | Navigator.RouteStatus | RouteStatus, setDestination(Waypoint) tarafından döndürülen İleri aracılığıyla erişilen rota hesaplamasının sonucunu temsil eden bir durum kodudur. |
Herkese Açık Yöntem Özeti
soyut geçersiz |
cleanup()
Gezgin'in dahili durumunu temizler.
|
soyut geçersiz |
clearDestinations()
Önceden ayarlanmış tüm hedefleri temizler ve hesaplanan rotaları haritadan kaldırır.
|
soyut geçersiz |
clearLicensePlateRestrictionInfo()
Mevcut sürücüyle ilgili plaka bilgilerini temizler.
|
soyut geçersiz |
clearRemainingTimeOrDistanceChangedListener()
Kalan süre veya mesafedeki değişiklikleri öğrenmek için işleyiciyi temizler.
|
soyut Ara nokta |
continueToNextDestination()
Mevcut hedefi kaldırır.
|
soyut ListenableResultFuture<RouteInfo> |
fetchRouteInfo(Ara nokta referans noktası, RoutingOptions yönlendirme Seçenekleri)
Her
RoutingOptions.RoutingStrategy değerine göre rotalar için rota bilgilerini döndürür. |
soyut RouteSegment |
getCurrentRouteSegment()
Yolculuğun mevcut ayağını döndürür.
|
soyut TimeAndDistance |
getCurrentTimeAndDistance()
Mevcut konumdan geçerli hedefe olan tahmini süreyi ve mesafeyi döndürür.
|
abstract Liste<RouteSegment> |
getRouteSegments()
Rota segmentlerinin bir listesini döndürür.
|
soyut Simülatör |
getSimulator()
Test sırasında kullanılmak üzere bir Simülatör nesnesi döndürür.
|
abstract Liste<TimeAndDistance> |
getTimeAndDistanceList()
Geçerli rotadaki her bir hedefe karşılık gelen zamanların ve mesafelerin listesini döndürür ve mevcut konumdan her bir hedefe olan tahmini süreyi ve mesafeyi temsil eder.
|
abstract Liste<LatLng> |
getTraveledRoute()
Bu rehberlik oturumu sırasında (
startGuidance() için son çağrıdan bu yana) şimdiye kadar katedilen rotayı döndürür. |
soyut boole |
isGuidanceRunning()
Yönlendirme şu anda çalışıyorsa
true değerini döndürür. |
soyut geçersiz |
setArrivalListener(Navigator.ArrivalListener işleyici)
Varış etkinlikleri için bir işleyici kaydeder.
|
soyut geçersiz |
setAudioGuidance(int rehber)
Hangi tür sesli yardımların (titreşim dahil) etkinleştirileceğini ayarlar.
|
soyut ListenableResultFuture<Navigator.RouteStatus> |
setDestination(Ara nokta hedefi, RoutingOptions yönlendirmeSeçenekleri, DisplayOptions displayOptions)
Navigasyon için tek bir hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
|
soyut ListenableResultFuture<Navigator.RouteStatus> |
setDestination(Ara nokta hedefi, RoutingOptions seçenekleri)
Navigasyon için tek bir hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
|
soyut ListenableResultFuture<Navigator.RouteStatus> |
setDestination(Ara nokta hedefi)
Navigasyon için tek bir hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
|
soyut ListenableResultFuture<Navigator.RouteStatus> |
setDestinations(Liste<Ara nokta> hedefleri, RoutingOptions seçenekleri)
Navigasyon için birden çok hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
|
soyut ListenableResultFuture<Navigator.RouteStatus> |
setDestinations(Liste<Ara nokta> hedefler, RoutingOptions yönlendirmeSeçenekleri, DisplayOptions displayOptions)
Navigasyon için birden çok hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
|
soyut ListenableResultFuture<Navigator.RouteStatus> |
setDestinations(Liste<Ara nokta> hedefleri)
Navigasyon için birden çok hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
|
soyut geçersiz |
setHeadsUpNotificationEnabled(boole etkin)
Uyarı bildirimlerinin gösterilip gösterilmeyeceğini ayarlar.
|
soyut geçersiz |
setLicensePlateRestrictionInfo(intRAW LicensePlateLastDigit, String LicensePlateCountryCode)
Mevcut sürücüyle ilgili plaka bilgilerini ayarlar.
|
soyut geçersiz |
setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, int rangeChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener işleyicisi)
Hedefe kalan süre veya mesafe belirtilen bir eşikten fazla değiştiğinde bir işleyici kaydeder.
|
soyut geçersiz |
setRouteChangedListener(Navigator.RouteChangedListener işleyicisi)
Rota değişikliği etkinlikleri için bir işleyici kaydeder.
|
soyut geçersiz |
setSpeedingListener(SpeedingListener SpeedingListener)
Sürücünün şu anda sürüş yaptığı hız sınırının üzerindeki yüzde için
SpeedingListener kaydeder. |
soyut geçersiz |
startGuidance(Intent reviewIntent)
startGuidance() ile aynıdır, ancak gezginin durum çubuğu bildiriminden uygulamayı devam ettirmek için kullanılabilecek bir amaç belirtir. |
soyut geçersiz |
startGuidance()
Bir hedef ayarlanmışsa ve hedef için bir rota hesaplandıysa, rota için adım adım navigasyon rehberliğini başlatır.
|
soyut geçersiz |
stopGuidance()
Adım adım navigasyon rehberliğini durdurur.
|
Herkese Açık Yöntemler
herkese açık soyut void temizlenme ()
Gezgin'in dahili durumunu temizler.
Not: Bu yöntemin çağrılması, setDestinations(List
adresine gönderilen tüm bekleyen istekler iptal edilir.
herkese açık soyut void clearDestinations ()
Önceden ayarlanmış tüm hedefleri temizler ve hesaplanan rotaları haritadan kaldırır. Navigasyon çalışıyorsa navigasyonu otomatik olarak durdurur.
Public soyut void clearLicensePlateRestrictionInfo ()
Mevcut sürücüyle ilgili plaka bilgilerini temizler. Bu ayar yalnızca bu değer ayarlandıktan sonra yapılan setDestination çağrıları için geçerlidir.
herkese açık soyut void clearRemainingTimeOrDistanceChangedListener ()
Kalan süre veya mesafedeki değişiklikleri öğrenmek için işleyiciyi temizler.
herkese açık soyut Ara nokta continueToNextDestination ()
Mevcut hedefi kaldırır. Bu görüşmenin ardından, bir sonraki hedef için rehberlik sunulur ve eski hedef hakkında bilgi verilmez.
İlerlemeler
- referans noktası rehberi şimdi gidiyor veya başka ara nokta yoksa null
herkese açık abstract ListenableResultFuture<RouteInfo> fetchRouteInfo (Ara nokta, RoutingOptions redirectOptions)
Her RoutingOptions.RoutingStrategy
değerine göre rotalar için rota bilgilerini döndürür. Bu yöntem tüm yönlendirme stratejileri için rota bilgilerini döndürdüğünden RoutingOptions.RoutingStrategy
yok sayılır.
Not: Bu değer her aramada yeniden hesaplanır ve arada trafik ve diğer faktörler güncellenmiş olabileceğinden, şu anda navigasyon tarafından kullanılan rotalarla eşleşmeyebilir.
Parametreler
referans noktaları | rota için hedef ara nokta |
---|---|
routingOptions | rota bilgilerini getirmek için kullanılan seçenekler |
İlerlemeler
- iade edilen gelecek
herkese açık soyut RouteSegment getCurrentRouteSegment ()
Yolculuğun mevcut ayağını döndürür. Bu Güzergah Segmenti, başlangıç konumunu cihazın bilinen en son (yola yakın konumdaki) konumu olarak görür.
İlerlemeler
- bir rota segment nesnesi veya geçerli rota yoksa
null
herkese açık soyut TimeAndDistance getCurrentTimeAndDistance ()
Mevcut konumdan geçerli hedefe olan tahmini süreyi ve mesafeyi döndürür.
İlerlemeler
- bir zaman ve mesafe nesnesi veya geçerli rota yoksa
null
genel soyut Liste<RouteSegment> getRouteSegments ()
Rota segmentlerinin bir listesini döndürür. Döndürülen her segmentin hedefi, setDestination(s) tarafından belirlenen bir hedefe karşılık gelir.
herkese açık soyut Simulator getSimulator ()
Test sırasında kullanılmak üzere bir Simülatör nesnesi döndürür.
herkese açık soyut Liste<TimeAndDistance> getTimeAndDistanceList ()
Geçerli rotadaki her bir hedefe karşılık gelen zamanların ve mesafelerin listesini döndürür ve mevcut konumdan her bir hedefe olan tahmini süreyi ve mesafeyi temsil eder.
genel soyut Liste<LatLng> getTraveledRoute ()
Bu rehberlik oturumunda (startGuidance()
öğesine yapılan son çağrıdan bu yana) şimdiye kadar katedilen rotayı döndürür. Kaydedilen rota, RoadSnappedLocationProvider
tarafından döndürülecek şekilde yolla bir araya getirilmiş konumlardan oluşur ve gereksiz noktaların kaldırılması basitleştirilmiştir (ör. ardışık doğrusal noktaları tek bir çizgi segmentine dönüştürmek).
herkese açık soyut boole isGuidanceRunning ()
Yönlendirme şu anda çalışıyorsa true
değerini döndürür. Yönlendirmenin yalnızca hedefe giden rota hesaplandıktan ve startGuidance()
çağrıldıktan sonra çalıştırılacağını unutmayın.
herkese açık soyut void setArrivalListener (Navigator.ArrivalListener dinleyici)
Varış etkinlikleri için bir işleyici kaydeder. Önceden kayıtlı işleyicileri geçersiz kılar.
Not: Bellek sızıntılarını önlemek için işleyici artık gerekli olmadığında setNavArrivalListener(null)
çağrılmalıdır.
Parametreler
işleyici | dinlemekle ilgili sorular sorar. Önceden kaydedilmiş bir işleyiciyi temizlemek için null olarak ayarlanabilir.
|
---|
herkese açık soyut void setAudioGuidance (int kılavuzu)
Hangi tür sesli yardımların (titreşim dahil) etkinleştirileceğini ayarlar. Varsayılan olarak titreşim, ses ve Bluetooth üzerinden ses (varsa) etkindir.
Bu yöntem, kullanıcı arayüzü iş parçacığında çağrılmalıdır.
Parametreler
rehberlik | ne tür sesli yardımın etkinleştirilmesi gerektiğini belirten Navigator.AudioGuidance işaretlerinin kombinasyonu
|
---|
herkese açık soyut ListenableResultFuture<Navigator.RouteStatus> setDestination ((Ara nokta hedefi, RoutingOptions yönlendirmeSeçenekleri, DisplayOptions displayOptions)
Navigasyon için tek bir hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. Kullanıcının konumundan belirtilen hedefe giden bir rota bulunursa döndürülen gelecek OK
olarak ayarlanır.
Parametreler
hedef | belirlenecek yeni hedef |
---|---|
routingOptions | rota oluşturmak için kullanılacak seçenekler |
displayOptions | rotayı görüntülemek için kullanılacak seçenekler |
İlerlemeler
- iade edilen gelecek
Dekoratif yastıklar
NullPointerException | belirtilen hedef null ise |
---|
herkese açık soyut ListenableResultFuture<Navigator.RouteStatus> setDestination (Ara nokta hedefi, RoutingOptions seçenekleri)
Navigasyon için tek bir hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. Kullanıcının konumundan belirtilen hedefe giden bir rota bulunursa döndürülen gelecek OK
olarak ayarlanır. Rotayı görüntülemek için varsayılan DisplayOptions
kullanılır.
Parametreler
hedef | belirlenecek yeni hedef |
---|---|
seçenekler | rota oluşturmak için kullanılacak seçenekler |
İlerlemeler
- iade edilen gelecek
Dekoratif yastıklar
NullPointerException | belirtilen hedef null ise |
---|
herkese açık soyut ListenableResultFuture<Navigator.RouteStatus> setDestination (Ara nokta hedefi)
Navigasyon için tek bir hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. Kullanıcının konumundan belirtilen hedefe giden bir rota bulunursa döndürülen gelecek OK
olarak ayarlanır. Rotayı bulmak için varsayılan RoutingOptions
, görüntülemek için de varsayılan DisplayOptions
kullanılır.
Parametreler
hedef | belirlenecek yeni hedef |
---|
İlerlemeler
- iade edilen gelecek
Dekoratif yastıklar
NullPointerException | belirtilen hedef null ise |
---|
herkese açık soyut ListenableResultFuture<Navigator.RouteStatus> setDestinations (Liste<Ara nokta> hedefler, RoutingOptions seçenekleri)
Navigasyon için birden çok hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. Kullanıcının konumundan belirtilen hedefe giden bir rota bulunursa döndürülen gelecek OK
olarak ayarlanır. Rotayı görüntülemek için varsayılan DisplayOptions
kullanılır.
Parametreler
hedefler | ayarlanacak yeni hedef listesi |
---|---|
seçenekler | rota oluşturmak için kullanılacak seçenekler |
İlerlemeler
- iade edilen gelecek
herkese açık soyut ListenableResultFuture<Navigator.RouteStatus> setDestinations (Liste<Ara nokta> hedefler, RoutingOptions yönlendirme seçenekleri, DisplayOptions displayOptions)
Navigasyon için birden çok hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. Kullanıcının konumundan belirtilen hedefe giden bir rota bulunursa döndürülen gelecek OK
olarak ayarlanır.
Parametreler
hedefler | ayarlanacak yeni hedef listesi |
---|---|
routingOptions | rota oluşturmak için kullanılacak seçenekler |
displayOptions | rotayı görüntülemek için kullanılacak seçenekler |
İlerlemeler
- iade edilen gelecek
herkese açık soyut ListenableResultFuture<Navigator.RouteStatus> setDestinations (Liste<Ara nokta> hedefleri)
Navigasyon için birden çok hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. Kullanıcının konumundan belirtilen hedefe giden bir rota bulunursa döndürülen gelecek OK
olarak ayarlanır. Rotayı bulmak için varsayılan RoutingOptions
, görüntülemek için de varsayılan DisplayOptions
kullanılır.
Parametreler
hedefler | ayarlanacak yeni hedef listesi |
---|
İlerlemeler
- iade edilen gelecek
herkese açık soyut void setHeadsUpNotificationEnabled (boolean enabled)
Uyarı bildirimlerinin gösterilip gösterilmeyeceğini ayarlar. Bildirim varsayılan olarak etkindir. Uyarı etkinlikleri, görünür harita olmadığında görüntülenen, dönüşler gibi yol gösterici etkinliklerdir.
Bu yöntem, kullanıcı arayüzü iş parçacığında çağrılmalıdır.
Parametreler
etkin | uyarı bildirimlerinin etkinleştirilmesi gerekip gerekmediğini belirten bir işaret |
---|
herkese açık soyut void setLicensePlateRestrictionInfo (intRAWLicensePlateLastDigit, String LicensePlateCountryCode)
Mevcut sürücüyle ilgili plaka bilgilerini ayarlar. Bu, plaka numarasına göre belirlenen belirli yol kısıtlaması türlerinden bazılarını yönlendirmemize olanak tanır. Bu ayar yalnızca bu değer ayarlandıktan sonra yapılan setDestination çağrıları için geçerlidir. Tercihen, gezgini aldıktan hemen sonra bunu çağırmanız gerekir.
Parametreler
rawLicensePlateLastDigit | Plakanın son basamağı (0 ile 9 arasında olmalıdır). |
---|---|
licensePlateCountryCode | Şu anda Endonezya (ID) ve Brezilya (BZ) için diğer ülkeler desteklenmektedir. Bu destek gelecekte desteklenebilir. Siz de bu bilgileri proaktif olarak sağlayabilirsiniz. |
genel setRemainingTimeOrDistanceChangedListenerNavigator.RemainingTimeOrDistanceChangedListener
Hedefe kalan süre veya mesafe belirtilen bir eşikten fazla değiştiğinde bir işleyici kaydeder. Önceden kayıtlı işleyicileri geçersiz kılar.
Dinleyici, örneğin kullanıcı hareketi, trafik koşullarında değişiklik, rota değişikliği, hedef değişikliği ya da kalan süre ve mesafe ilk kez bilindiğinde çağrılabilir.
Not: Bellek sızıntılarını önlemek için işleyici artık gerekli olmadığında clearNavProgressionListener()
çağrılmalıdır.
Parametreler
timeChangeThresholdSeconds | Kalan sürenin saniye cinsinden mutlak değişimi bu değerden büyükse veya bu değere eşitse işleyici çağrılır. Bu eşik negatif olmamalıdır. |
---|---|
distanceChangeThresholdMeters | Metre cinsinden kalan mesafedeki mutlak değişim bu değerden büyükse veya bu değere eşitse dinleyici çağrılır. Bu eşik negatif olmamalıdır. |
işleyici | dinlemekle ilgili sorular sorar. null olmamalıdır.
|
herkese açık soyut void setRouteChangedListener (Navigator.RouteChangedListener işleyici)
Rota değişikliği etkinlikleri için bir işleyici kaydeder. Önceden kayıtlı işleyicileri geçersiz kılar.
Not: Bellek sızıntılarını önlemek için işleyici artık gerekli olmadığında setNavRouteChangeListener(null)
çağrılmalıdır.
Parametreler
işleyici | dinlemekle ilgili sorular sorar. Önceden kaydedilmiş bir işleyiciyi temizlemek için null olarak ayarlanabilir.
|
---|
herkese açık soyut void setSpeedingListener (SpeedingListener hızingListener)
Sürücünün şu anda sürüş yaptığı hız sınırının üzerindeki yüzde için SpeedingListener
kaydeder.
null
SpeedingListener
ayarladığınızda veya ayarlamadığınızda hızlı feed verisi almazsınız.
Parametreler
speedingListener |
---|
herkese açık soyut void startGuidance (Intent reviewIntent)
startGuidance()
ile aynıdır, ancak gezginin durum çubuğu bildiriminden uygulamayı devam ettirmek için kullanılabilecek bir amaç belirtir. Bu amaç olmadan, uygulamayı durum çubuğundan devam ettirmek mümkün değildir.
Parametreler
resumeIntent | ve uygulamayı devam ettirme amacı da olabilir. Çoğu durumda, android.app.Activity#getIntent() tarafından döndürülen değer uygun olacaktır.
|
---|
herkese açık soyut void startGuidance ()
Bir hedef ayarlanmışsa ve hedef için bir rota hesaplandıysa, rota için adım adım navigasyon rehberliğini başlatır. Bir rota henüz hesaplanmadıysa adım adım rehberlik, hesaplandıktan sonra başlar.
Gezinme hizmetini durdurmak için stopGuidance() işlevini açıkça çağırmanız gerekir. Navigasyon hizmeti varışta otomatik olarak durmaz. Varışta navigasyon hizmetini durdurmak isterseniz NavArrivalListener'dan stopGuidance() işlevini çağırmanız gerekir.
Not: Bu yöntem Camera
öğesinin konumunu değiştirmez.
herkese açık soyut void stopGuidance ()
Adım adım navigasyon rehberliğini durdurur.