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ı.

Bu yöntemi çağırmak 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.

- (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.

GMSNavigator Sınıf Referansı

Genel bakış

Herkese Açık Üye İşlevleri

Mülkler

İlgili İşlevler

Üye İşlevi Belgeleri

Arkadaşlar ve İlişkilendirilen İşlev Belgeleri

Mülkiyet Belgeleri