Genel bakış
Bu, iOS için Google Navigasyon SDK'sının ana sınıfıdır ve bir hedefe gitmeyi denetleme, rota ve ilerleme bilgilerine erişim için yöntemler sağlar.
Bu sınıf alt sınıflandırmayı desteklemiyor.
Bu sınıf ileti dizisi açısından güvenli değil. Tüm yöntemler ana iş parçacığından çağrılmalıdır.
Herkese Açık Üye İşlevleri | |
(void) | - addListener: |
İşleyici ekler. | |
(BOOL) | - removeListener: |
Bir işleyiciyi kaldırır. | |
(void) | - setDestinations:callback: |
Navigasyon için birden fazla hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. | |
(void) | - setDestinations:routingOptions:callback: |
Navigasyon için birden fazla hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar. | |
(void) | - setDestinations:routeToken:callback: |
Önceden hesaplanmış bir rotada gezinmek için bir rota jetonu kullanarak navigasyon için birden fazla hedef ayarlar. | |
(void) | - getRouteInfoForDestination:withRoutingOptions:callback: |
Yönlendirme stratejisine göre rota bilgilerini döndürür: varsayılan en iyi veya daha kısa rota. | |
(boş değer GMSNavigationWaypoint *) | - continueToNextDestination |
Kullanımdan kaldırıldı. | |
(void) | - clearDestinations |
Önceden ayarlanmış tüm hedefleri temizler ve hesaplanmış rotaları haritadan kaldırır. | |
(NSTimeInterval) | - Waypoint: |
Belirli bir ara noktanın tahmini süresini veya ara nokta geçerli rotanın bir parçası değilse CLTimeIntervalMax değerini döndürür. | |
(CLLocationRemote) | - distanceToWaypoint: |
Belirli bir ara noktanın tahmini mesafesini veya ara nokta geçerli rotanın bir parçası değilse CLLocationLocationMax değerini döndürür. | |
(void) | - setTransactionIDs:errorHandler: |
Mevcut gezinme oturumu sırasında gezinme etkinliklerine uygulanan devam eden işlem kimliklerini ayarlar ve sunucuya kaydeder. | |
Mülkler | |
BOOL | avoidsHighways |
Varış noktalarına rota oluştururken otoyollardan kaçınılmalı. | |
BOOL | avoidsTolls |
Hedefler için rota oluştururken paralı yollardan kaçınılmayacağı. | |
BOOL | avoidsFerries |
Varış noktalarına rota oluştururken feribotlardan kaçınılma durumu. | |
GMSNavigationLicensePlateRestriction * | licensePlateRestriction |
Plaka kısıtlamasını, sürücünün plakasının son basamağı ve ülke koduyla ayarlayın. | |
BOOL | guidanceActive |
Adım adım yardımın şu anda etkin olup olmadığı. | |
BOOL | stopGuidanceAtArrival |
-navigator :didReachAtWaypoint: çağrıldığında kılavuzun otomatik olarak durup durmayacağı. | |
NSTimeInterval | timeUpdateThreshold |
navigator:didUpdateRemainingTime: yönteminin çağrılmasını tetikleyecek bir sonraki hedef için tahmini süredeki minimum değişiklik. | |
CLLocationLocation | distanceUpdateThreshold |
navigator:didUpdateRemainingDistance: yönteminin çağrılmasını tetikleyecek bir sonraki hedefe olan tahmini mesafedeki minimum değişiklik. | |
NSTimeInterval | timeToNextDestination |
Bir sonraki hedefe kalan tahmini süreyi döndürür. | |
CLLocationLocation | distanceToNextDestination |
Bir sonraki hedefe olan tahmini mesafeyi döndürür. | |
GMS NavigationDelayCategory | delayCategoryToNextDestination |
Gecikme kategorisini bir sonraki hedefe döndürür. | |
GMSRouteLeg * | currentRouteLeg |
Yolculuğun mevcut ayağı. | |
NSArray< GMSRouteLeg * > * | routeLegs |
Her bacağın ayarlanan bir hedefe karşılık geldiği rota ayağı dizisi. | |
GMSPath * | traveledPath |
GuideActive'ın son olarak EVET olarak ayarlanmasından bu yana cihazın gittiği yol. | |
GMSNavigationVoiceGuidance | voiceGuidance |
Trafik ve adım adım uyarılar için sesli yardımın etkinleştirilip etkinleştirilmeyeceğini belirler. | |
GMSVoiceGuidanceAudioDeviceType | audioDeviceType |
Sesli yardımın hangi sesli cihazlarda oynatılabileceğini belirler. | |
BOOL | vibrationEnabled |
Sesli uyarılar çalındığında cihazın da titreşip titreşmeyeceğini belirler. | |
BOOL | sendsBackgroundNotifications |
Yol gösterici bilgiler içeren UILocalBildirimler'in, uygulama arka plandayken gösterilip gösterilmeyeceğini belirler. | |
GMSNavigationLightingMode | suggestedLightingMode |
Günün saatine ve cihaz konumuna göre önerilen ışıklandırma modu. | |
BOOL | shouldDisplayPrompts |
Trafik, daha iyi rotalar ve olaylarla ilgili istemlerin görüntülenip görüntülenmeyeceğini belirler. | |
GMSNavigationSpeedAlertOptions * | speedAlertOptions |
GMS NavigationSpeedAlertSeverity için tetikleme eşiklerini özelleştirmek amacıyla GMSNavigationSpeedAlertOptions. | |
İlgili İşlevler | |
(Bunların üye işlevleri olmadığını unutmayın.) | |
typedef void(^ | GMSRouteStatusCallback )(GMSRouteStatus routeStatus) |
Cihazın konumundan sağlanan hedeflere giden bir rota bulunduğunda veya RouteStatus'da belirtilen bir nedenden dolayı bulunamadığında çağrılır. | |
typedef void(^ | GMSRouteInfoCallback )(GMSNavigationRouteInfo *_Nullable routeInfo) |
Sağlanan ara noktayla ilişkili rota bilgileri (ETA ve mesafe) hesaplanırken çağrılır. | |
typedef void(^ | GMSNavigationTransactionIDErrorHandler )(NSError *hata) |
işlem kimliklerinin setTransactionID'leri aracılığıyla ayarlanması başarısız olursa çağrılır. |
Üye İşlevi Belgeleri
- (void) addListener: | (kimlik< GMSNavigatorListener >) | dinleyici |
İşleyici ekler.
Dinleyici zayıf bir referansla tutulur.
- Parametreler:
-
işleyici GMSNavigatorListener
protokolüne uygun bir nesne.
- (BOOL) removeListener: | (kimlik< GMSNavigatorListener >) | dinleyici |
Bir işleyiciyi kaldırır.
- Parametreler:
-
işleyici GMSNavigatorListener
protokolüne uygun bir nesne.
- İadeler:
- Dinleyici kaldırıldıysa EVET değerini döndürür. Nesne bir işleyici değilse HAYIR değerini döndürür.
- (void) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | hedefler | |
geri arama: | (GMSRouteStatusCallback) | geri arama | |
Navigasyon için birden fazla hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
Cihazın konumundan belirtilen hedefe bir rota bulunursa, sağlanan geri çağırma GMSRouteStatusOK ile çağrılır. Bir rota bulunmadan önce yeni bir hedef ayarlanırsa istek iptal edilir ve geri arama GMSRouteStatusCanceled ile çağrılır. Bir rota başka bir nedenle bulunamazsa, geri arama uygun bir hata durumuyla çağrılır.
Geri çağırma, ana sırada her zaman eşzamansız olarak dağıtılır.
- (void) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | hedefler | |
redirectOptions: | (GMSNavigationRoutingOptions *) | routingOptions | |
geri arama: | (GMSRouteStatusCallback) | geri arama | |
Navigasyon için birden fazla hedef ayarlayarak önceden ayarlanmış hedefleri geçersiz kılar.
Döndürülen rotalar, yönlendirme seçenekleri kullanılarak hesaplanır.
- Parametreler:
-
hedefler Hedef ara noktalar dizisi. routingOptions Yönlendirme mantığını (yönlendirme stratejisi) etkileyen seçenekler. geri çağırma Tüketicinin konumundan sağlanan hedeflere giden bir rota bulunduğunda veya RouteStatus özelliğinde belirtilen bir nedenden ötürü bulunamazsa çağrılır.
- (void) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | hedefler | |
pathToken: | (NSString *) | routeToken | |
geri arama: | (GMSRouteStatusCallback) | geri arama | |
Önceden hesaplanmış bir rotada gezinmek için bir rota jetonu kullanarak navigasyon için birden fazla hedef ayarlar.
Rotalar, sürücünün başlangıç konumuna ve yol/trafik koşullarına göre aynı şekilde olacak. Jetonda kodlanan yönlendirme seçeneklerine göre yeniden rotalar uygulanmaya devam eder.
Navigasyon oturumu başlatmak için rota jetonunu kullandığınızda yalnızca GMSNavigationTravelModeDriving
ve GMSNavigationTravelModeTwoWheeler
desteklenir. travelMode
ayarını yaparak ulaşım şeklini yapılandırın. Mevcut ulaşım şekli desteklenmiyorsa arama başarısız olur ve geri çağırmada bir GMSRouteStatusTravelModeUnsupported
döndürülür.
- Parametreler:
-
hedefler Bir hedef ara noktalar dizisi, rota jetonunu almak için RoutesPreferred API'ye verilen hedeflerle aynı olmalıdır. routeToken RoutesPreferred API tarafından döndürülen bir rota jetonu dizesi. RoutesPreferred API'de belirtilen yönlendirme seçenekleri bu rota jetonunda kodlanır ve yeniden rota gerçekleştiğinde, önceden hesaplanmış rotayı veya yeni bir rotayı yeniden oluşturmak için kullanılır. geri çağırma Tüketicinin konumundan sağlanan hedeflere giden bir yol bulunduğunda veya RouteStatus özelliğinde belirtilen bir nedenden dolayı bulunamazsa çağrılır.
- (void) getRouteInfoForDestination: | (GMSNavigationWaypoint *) | hedef | |
withYönlendirmeSeçenekleri: | (GMSNavigationRoutingOptions *) | routingOptions | |
geri arama: | (GMSRouteInfoCallback) | geri arama | |
Yönlendirme stratejisine göre rota bilgilerini döndürür: varsayılan en iyi veya daha kısa rota.
Projenin bu API'yi çağırma izni yoksa bir nil
değeri döndürür.
- Parametreler:
-
hedef Varış noktası. routingOptions Rota bilgilerini getirmek için kullanılan seçenekler. Bu yöntem tüm rota stratejileri için rota bilgilerini döndürdüğünden, yönlendirme stratejisi ve alternatif rota stratejisi yoksayılır. geri çağırma Rota bilgileri alındığında çağrılan geri arama.
- (boş değer GMSNavigationWaypoint *) continueToNextDestination |
Kullanımdan kaldırıldı.
Bunun yerine, yeni hedef listesiyle -setDestinations
:... yöntemlerinden birini çağırın.
Mevcut hedef listesindeki ilk hedefi açar. Bu görüşmeden sonra rehberlik varsa bir sonraki hedefe yönlendirilir.
- İadeler:
- referans noktası rehberi doğru yöndedir ya da başka ara nokta yoksa yok olur.
- Not:
- Bu özelliğin desteği sonlandırılmıştır. Bunun yerine -setDestinations:... yöntemlerinden birini kullanın.
- (void) clearDestinations |
Önceden ayarlanmış tüm hedefleri temizler ve hesaplanmış rotaları haritadan kaldırır.
Yardım etkinse otomatik olarak durdurulur.
- (NSTimeInterval) timeToWaypoint: | (GMSNavigationWaypoint *) | ara nokta |
Belirli bir ara noktanın tahmini süresini veya ara nokta geçerli rotanın bir parçası değilse CLTimeIntervalMax değerini döndürür.
Bu bilgi, rehberlik etkinken cihazın mevcut konumuna göre güncellenir.
Sağlanan ara nokta geçerli rotadaki bir hedef değilse CLTimeIntervalMax değerini döndürür.
- (CLLocationDistance) distanceToWaypoint: | (GMSNavigationWaypoint *) | ara nokta |
Belirli bir ara noktanın tahmini mesafesini veya ara nokta geçerli rotanın bir parçası değilse CLLocationLocationMax değerini döndürür.
Rehberlik etkin durumdayken cihazın mevcut konumuna göre bu bilgi güncellenir.
Sağlanan ara nokta geçerli rotadaki bir hedef değilse CLLocationLocationMax değerini döndürür.
- (geçersiz) setTransactionIDs: | (NSArray< NSString * > *) | transactionIDs | |
errorHandler: | (boş değer GMSNavigationTransactionIDErrorHandler) | errorHandler | |
Mevcut gezinme oturumu sırasında gezinme etkinliklerine uygulanan devam eden işlem kimliklerini ayarlar ve sunucuya kaydeder.
İşlem kimlikleri, gezinme oturumunun sonunda silinir.
- Parametreler:
-
transactionIDs Mevcut gezinme oturumu için geçerli olan işlem kimlikleri. İşlem kimliği, faturalandırılabilir her işlem için benzersiz olmalıdır. Tek bir işlem kimliği en az bir, en fazla 64 karakter içermelidir. Bir işlem sona erdiğinde (ancak oturum devam ediyorsa) liste boş olabilir. errorHandler İşlem kimlikleri geçersiz olduğunda hata oluşursa ana iş parçacığında eşzamansız olarak çağrılacak bir blok.
Arkadaşlar ve İlişkilendirilen İşlev Belgeleri
- (typedef void(^ GMSRouteStatusCallback)(GMSRouteStatusrouteStatus))) [related] |
Cihazın konumundan sağlanan hedeflere giden bir rota bulunduğunda veya RouteStatus'da belirtilen bir nedenden dolayı bulunamadığında çağrılır.
- (typedef void(^ GMSRouteInfoCallback)(GMSNavigationRouteInfo *_NullableRouteInfo)) [related] |
Sağlanan ara noktayla ilişkili rota bilgileri (ETA ve mesafe) hesaplanırken çağrılır.
- Parametreler:
-
routeInfo Belirtilen hedefe ilişkin rota bilgisi. Hesaplama başarısız olursa boş olur.
- (typedef void(^ GMSNavigationTransactionIDErrorHandler)(NSError *hata)) [related] |
işlem kimliklerinin setTransactionID'leri aracılığıyla ayarlanması başarısız olursa çağrılır.
Daha fazla bilgi için API belgelerine göz atın.
Mülkiyet Belgeleri
- (BOOL) avoidsHighways [read, write, assign] |
Varış noktalarına rota oluştururken otoyollardan kaçınılmalı.
Varsayılan olarak NO değerine ayarlanır.
- (BOOL) avoidsTolls [read, write, assign] |
Hedefler için rota oluştururken paralı yollardan kaçınılmayacağı.
Varsayılan olarak NO değerine ayarlanır.
- (BOOL) avoidsFerries [read, write, assign] |
Varış noktalarına rota oluştururken feribotlardan kaçınılma durumu.
Varsayılan olarak YES değerine ayarlanır.
- (GMSNavigationLicensePlateRestriction*) licensePlateRestriction [read, write, assign] |
Plaka kısıtlamasını, sürücünün plakasının son basamağı ve ülke koduyla ayarlayın.
Bu, plaka numarasına dayalı olarak belirli türdeki yol kısıtlamalarını aşmamıza olanak tanır. Bu ayar yalnızca bu değer ayarlandıktan sonra yapılan setDestinations çağrıları için geçerlidir. İdeal olarak, bunu, gezgini aldıktan hemen sonra ayarlamanız gerekir.
Plaka kısıtlaması yoksa boş olarak ayarlayın. Varsayılan olarak nil değerine ayarlanır.
- (BOOL) guidanceActive [read, write, assign] |
Adım adım yardımın şu anda etkin olup olmadığı.
GuideActive, EVET ise ancak şu anda mevcut bir rota yoksa, bir rota kullanılabilir olduğunda yardım başlar. clearDestinations çağrılırsa veya bir ara noktaya varırsak bu özellik HAYIR olarak ayarlanır.
- (BOOL) stopGuidanceAtArrival [read, write, assign] |
-navigator
:didReachAtWaypoint: çağrıldığında kılavuzun otomatik olarak durup durmayacağı.
HAYIR değerine ayarlanırsa gezinme üst bilgisi ve alt bilgisi varıştan sonra gösterilmeye devam eder. Gezinme başlığında son yol gösterici adımı göstermeye devam eder ve gezinme altbilgisi, 0 zaman/mesafeye ulaşılana kadar kalan süreyi ve mesafeyi güncellemeye devam eder. Ayrıca, -navigator
:didUpdateRemainingTime ve -navigator
:didUpdateRemainingMesafe güncellemeleri de devam edecek. Kılavuzu ve kalan süre/mesafe güncellemelerini durdurmak için guidanceActive
değerini açıkça NO değerine ayarlayın.
EVET ise guidanceActive
varışta otomatik olarak HAYIR şeklinde ayarlanır.
Varsayılan olarak YES değerine ayarlanır.
- (NSTimeInterval) timeUpdateThreshold [read, write, assign] |
navigator:didUpdateRemainingTime:
yönteminin çağrılmasını tetikleyecek bir sonraki hedef için tahmini süredeki minimum değişiklik.
Bu politika NSTimeIntervalMax olarak ayarlanırsa zaman güncelleme geri çağırmaları devre dışı bırakılır. Bu negatif bir değere ayarlanırsa bir saniyelik varsayılan eşik kullanılır. Varsayılan olarak bir saniye değerine ayarlanır.
- Not:
- Hiçbir işleyici
navigator:didUpdateRemainingTime:
uygulamasını uygulamazsa bu değer yoksayılır.
- (CLLocationDistance) distanceUpdateThreshold [read, write, assign] |
navigator:didUpdateRemainingDistance:
yönteminin çağrılmasını tetikleyecek bir sonraki hedefe olan tahmini mesafedeki minimum değişiklik.
Bu değer CLLocationDistanceMax olarak ayarlanırsa, mesafe güncelleme geri çağırmaları devre dışı bırakılır. Bu değer negatif bir değere ayarlanırsa bir metrelik varsayılan eşik kullanılır. Varsayılan değer bir metredir.
- Not:
- Hiçbir işleyici
navigator:didUpdateRemainingDistance:
uygulamasını uygulamazsa bu değer yoksayılır.
- (NSTimeInterval) timeToNextDestination [read, assign] |
Bir sonraki hedefe kalan tahmini süreyi döndürür.
Rehberlik etkin durumdayken cihazın mevcut konumuna göre bu bilgi güncellenir.
Kullanılabilir rota yoksa CLTimeIntervalMax değerini döndürür.
- (CLLocationDistance) distanceToNextDestination [read, assign] |
Bir sonraki hedefe olan tahmini mesafeyi döndürür.
Rehberlik etkin durumdayken cihazın mevcut konumuna göre bu bilgi güncellenir.
Kullanılabilir rota yoksa CLLocationLocationMax değerini döndürür.
- (GMSNavigationDelayCategory) delayCategoryToNextDestination [read, assign] |
Gecikme kategorisini bir sonraki hedefe döndürür.
Rehberlik etkin durumdayken cihazın mevcut konumuna göre bu bilgi güncellenir.
Kullanılabilir rota yoksa veya trafik verileri mevcut değilse GMS NavigationDelayCategoryNoData değerini döndürür.
- (GMSRouteLeg*) currentRouteLeg [read, assign] |
Yolculuğun mevcut ayağı.
Bu GMSRouteLeg, başlangıç konumunu cihazın bilinen en son (yola kesilmiş) konumu olarak görür.
- (NSArray<GMSRouteLeg *>*) routeLegs [read, assign] |
Her bacağın ayarlanan bir hedefe karşılık geldiği rota ayağı dizisi.
- (GMSPath*) traveledPath [read, assign] |
GuideActive'ın son olarak EVET olarak ayarlanmasından bu yana cihazın gittiği yol.
Yardım hiç başlamadıysa bu yol boştur. Yol, GMSRoadSnappedLocationProvider
tarafından döndürülen, yola eklenen konumdan oluşur ancak gereksiz noktaların kaldırılması basitleştirildi. Örneğin, ardışık doğrusal noktaları tek bir çizgi segmentine dönüştürebilirsiniz.
- (GMSNavigationVoiceGuidance) voiceGuidance [read, write, assign] |
Trafik ve adım adım uyarılar için sesli yardımın etkinleştirilip etkinleştirilmeyeceğini belirler.
Varsayılan olarak GMS NavigationVoiceGuidanceAlertsAndGuidance ayarlanır.
- (GMSVoiceGuidanceAudioDeviceType) audioDeviceType [read, write, assign] |
Sesli yardımın hangi sesli cihazlarda oynatılabileceğini belirler.
Varsayılan olarak GMSVoiceGuidanceAudioDeviceTypeBluetooth'a ayarlanır.
- (BOOL) vibrationEnabled [read, write, assign] |
Sesli uyarılar çalındığında cihazın da titreşip titreşmeyeceğini belirler.
- (BOOL) sendsBackgroundNotifications [read, write, assign] |
Yol gösterici bilgiler içeren UILocalBildirimler'in, uygulama arka plandayken gösterilip gösterilmeyeceğini belirler.
Varsayılan olarak YES değerine ayarlanır.
- (GMSNavigationLightingMode) suggestedLightingMode [read, assign] |
Günün saatine ve cihaz konumuna göre önerilen ışıklandırma modu.
- (BOOL) shouldDisplayPrompts [read, write, assign] |
Trafik, daha iyi rotalar ve olaylarla ilgili istemlerin görüntülenip görüntülenmeyeceğini belirler.
Varsayılan olarak YES değerine ayarlanır.
- (GMSNavigationSpeedAlertOptions*) speedAlertOptions [read, write, assign] |
GMS NavigationSpeedAlertSeverity için tetikleme eşiklerini özelleştirmek amacıyla GMSNavigationSpeedAlertOptions.
Bu özelliği, hem küçük hem de önemli uyarılarda hız uyarısı tetikleme eşiklerini yüzde olarak özelleştirmek için kullanabilirsiniz. Bu yöntemi yüksek hız uyarıları için zamana dayalı tetikleme eşiğini özelleştirmek üzere de kullanabilirsiniz.
Hiç hız bilgilerini almazsanız NavSDK'nın varsayılan hız uyarısı görüntülenir: Hız uyarısı, hız limitinin 5 mil veya 10 km/sa. üzerine çıktığında kırmızı metin gösterir, 10 mil/sa. veya 20 km/sa.