Genel Bakış

Bu, iOS için Google Navigasyon SDK'sının ana sınıfıdır ve bir hedefe gitmeyi kontrol etme, rota ve ilerleme bilgilerine erişme konusunda yöntemler sağlar.

Bu sınıf, alt sınıfları desteklemiyor.

Bu sınıf, ileti dizisi için güvenli değil. Tüm yöntemler ana iş parçacığından çağrılmalıdır.

Genel Üye İşlevleri
(geçersiz)	- addListener:
	İşleyici ekler.
(BOOL)	- removeListener:
	İşleyiciyi kaldırır.
(geçersiz)	- setDestinations:callback:
	Gezinme için birden fazla hedef ayarlar ve önceden ayarlanmış olan hedefleri geçersiz kılar.
(geçersiz)	- setDestinations:routingOptions:callback:
	Gezinme için birden fazla hedef ayarlar ve önceden ayarlanmış olan hedefleri geçersiz kılar.
(geçersiz)	- setDestinations:routeToken:callback:
	Önceden hesaplanmış bir rotada gezinmek için bir rota jetonu kullanarak navigasyon için birden fazla hedef ayarlar.
(geçersiz)	- getRouteInfoForDestination:withRoutingOptions:callback:
	Rota stratejisine (varsayılan en iyi veya daha kısa rota) bağlı olarak rota bilgilerini döndürür.
(boş değer atanabilir GMSNavigationWaypoint *)	- continueToNextDestination
	Kullanımdan kaldırıldı.
(geçersiz)	- clearDestinations
	Önceden ayarlanmış tüm hedefleri temizler ve hesaplanan rotaları haritadan kaldırır.
(NSZaman Aralığı)	- timeToWaypoint:
	Verilen ara noktanın tahmini süresini veya ara nokta, geçerli rotanın parçası değilse CLTimeIntervalMax değerini döndürür.
(CLLocationDistance)	- distanceToWaypoint:
	Belirli bir ara nokta için tahmini mesafeyi veya ara nokta, geçerli rotanın parçası değilse CLLocationRemoteMax değerini döndürür.
(geçersiz)	- setTransactionIDs:errorHandler:
	Geçerli gezinme oturumu sırasında gezinme etkinlikleri için geçerli olan devam eden işlem kimliklerini ayarlar ve sunucuya günlüğe kaydeder.
Tesisler
BOOL	avoidsHighways
	Hedeflere giden rota oluşturulurken otoyolların kullanılıp kullanılmayacağını belirler.
BOOL	avoidsTolls
	Hedeflere giden rota oluştururken paralı yollardan kaçınılıp kaçınılmayacağını belirler.
BOOL	avoidsFerries
	Hedeflere giden rota oluştururken feribotların kullanılıp kullanılmayacağı.
GMSNavigationLicensePlateRestriction *	licensePlateRestriction
	Plaka kısıtlamasını, sürücünün plakasının son basamağı ve ülke koduyla belirleyin.
BOOL	guidanceActive
	Adım adım rehberliğin şu anda etkin olup olmadığı.
BOOL	stopGuidanceAtArrival
	`-navigator`:didReachAtWaypoint: çağrıldığında yönlendirmenin otomatik olarak durup durmayacağı.
NSTimeInterval	timeUpdateThreshold
	`navigator:didUpdateRemainingTime:` yönteminin çağrılmasını tetikleyecek bir sonraki hedefe kalan tahmini süredeki minimum değişim.
CLLocationDistance	distanceUpdateThreshold
	`navigator:didUpdateRemainingDistance:` yönteminin çağrılmasını tetikleyecek bir sonraki hedefe olan tahmini mesafedeki minimum değişim.
NSTimeInterval	timeToNextDestination
	Sonraki hedefe kalan tahmini süreyi döndürür.
CLLocationDistance	distanceToNextDestination
	Bir sonraki hedefe kalan tahmini mesafeyi döndürür.
GMSNavigationDelayCategory	delayCategoryToNextDestination
	Gecikme kategorisini sonraki hedefe döndürür.
GMSRouteLeg *	currentRouteLeg
	Yolculuğun mevcut ayağı.
NSArray< GMSRouteLeg * > *	routeLegs
	Her ayağın belirlenmiş bir hedefe karşılık geldiği rota bacakları dizisi.
GMSPath *	traveledPath
	Kullanıcının en son rehberlik oturumunda katettiği yol. Araç, en son EVET olarak ayarlandığı zaman olarak tanımlanır.
GMSNavigationVoiceGuidance	voiceGuidance
	Trafik ve adım adım uyarılar için sesli yardımın etkinleştirilip etkinleştirilmeyeceğini belirler.
GMSVoiceGuidanceAudioDeviceType	audioDeviceType
	Hangi ses cihazlarındaki sesli yardımın oynatılabileceğini belirler.
BOOL	vibrationEnabled
	Sesli uyarılar çalındığında cihazın da titreşip titreşmeyeceğini belirler.
BOOL	sendsBackgroundNotifications
	Uygulama arka plandayken rehberlik bilgileri içeren UILocalBildirimler'in sunulup sunulmayacağını belirler.
GMSNavigationLightingMode	suggestedLightingMode
	Günün saatine ve cihazın konumuna göre önerilen ışıklandırma modu.
BOOL	shouldDisplayPrompts
	Trafik, daha iyi rotalar ve olaylarla ilgili istemlerin gösterilip gösterilmeyeceğini belirler.
GMSNavigationSpeedAlertOptions *	speedAlertOptions
	GMSNavigationSpeedAlertOptions öğesini kullanarak GMSGezinmeSpeedAlertSeverity tetikleme eşiklerini özelleştirmenize olanak tanır.
İlgili İşlevler
(Bunların üye işlevleri olmadığını unutmayın.)
typedef void(^	GMSRouteStatusCallback )(GMSRouteStatus rotaStatus)
	Cihazın konumundan sağlanan hedeflere bir rota bulunduğunda veya RouteStatus tarafından belirtilen bir nedenden dolayı bulunamadığında çağrılır.
typedef void(^	GMSRouteInfoCallback )(GMSNavigationRouteInfo *_NullableRouteInfo)
	Sağlanan ara noktaya ilişkin rota bilgisi (TVS ve mesafe) hesaplandığında çağrılır.
typedef void(^	GMSNavigationTransactionIDErrorHandler )(NSError *hata)
	setTransactionIDs aracılığıyla işlem kimliklerinin ayarlanması başarısız olursa çağrılır.

Üye İşlevi Belgeleri

- (geçersiz) addListener: (kimlik< GMSNavigatorListener >) dinleyici

İşleyici ekler.

Dinleyici zayıf bir referansla tutuluyor.

Parametreler:

işleyici GMSNavigatorListener protokolüne uygun bir nesne.

- (BOOL) removeListener: (kimlik< GMSNavigatorListener >) dinleyici

İşleyiciyi kaldırır.

Parametreler:

işleyici GMSNavigatorListener protokolüne uygun bir nesne.

Şunu döndürür:: Dinleyici kaldırılırsa EVET değerini döndürür. Nesne bir işleyici değilse HAYIR değerini döndürür.

- (geçersiz) setDestinations (Geçersiz):	(NSArray< GMSNavigationWaypoint * > *)	hedefler
geri arama:	(GMSRouteStatusCallback)	geri arama

Gezinme için birden fazla hedef ayarlar ve önceden ayarlanmış olan hedefleri geçersiz kılar.

Cihazın konumundan belirtilen hedefe giden bir rota bulunursa, sağlanan geri çağırma GMSRouteStatusOK ile çağrılır. Rota bulunmadan önce yeni bir hedef ayarlanırsa istek iptal edilir ve geri çağırma, GMSRouteStatusCanceled ile çağrılır. Başka bir nedenle rota bulunamazsa uygun bir hata durumuyla birlikte geri arama yapılır.

Geri çağırma, ana sırada her zaman eşzamansız olarak gönderilir.

- (geçersiz) setDestinations (Geçersiz):	(NSArray< GMSNavigationWaypoint * > *)	hedefler
routingOptions:	(GMSNavigationRoutingOptions *)	routingOptions
geri arama:	(GMSRouteStatusCallback)	geri arama

Gezinme için birden fazla hedef ayarlar ve önceden ayarlanmış olan hedefleri geçersiz kılar.

Döndürülen rotalar, yönlendirme seçenekleri kullanılarak hesaplanır.

Parametreler:

hedefler	Bir dizi hedef ara nokta.
routingOptions	Yönlendirme mantığını (yönlendirme stratejisi) etkileyen seçenekler.
geri çağırma	Tüketicinin konumundan sağlanan hedeflere bir rota bulunduğunda veya RouteStatus tarafından belirtilen bir nedenden dolayı bulunamadığında çağrılır.

- (geçersiz) setDestinations (Geçersiz):	(NSArray< GMSNavigationWaypoint * > *)	hedefler
routeToken:	(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 aynı olacaktır. Sürücünün başlangıç konumunda ve yol/trafik koşullarında modülo değişikliklerinden ibarettir. Yeniden rotalar, jetonda kodlanan yönlendirme seçeneklerine bağlı olarak gerçekleşir.

Navigasyon oturumu başlatmak için rota jetonunu kullandığınızda yalnızca GMSNavigationTravelModeDriving ve GMSNavigationTravelModeTwoWheeler desteklenir. travelMode ayarlayarak ulaşım şeklini yapılandırın. Mevcut ulaşım modu desteklenmiyorsa çağrı başarısız olur ve geri çağırma sırasında GMSRouteStatusTravelModeUnsupported döndürülür.

Parametreler:

hedefler	Hedef ara noktaları dizisi, rota jetonunu almak için RoutesPreference API'ye verilen hedeflerle aynı olmalıdır.
routeToken	Routes Preferred API tarafından döndürülen rota jetonu dizesi. RoutesPreference API'de belirtilen yönlendirme seçenekleri, bu rota jetonunda kodlanır ve önceden hesaplanmış rotayı veya yeniden rota gerçekleştiğinde yeni bir rotayı yeniden oluşturmak için kullanılır.
geri çağırma	Tüketicinin konumundan sağlanan hedeflere bir rota bulunduğunda veya RouteStatus tarafından belirtilen bir nedenden dolayı bulunamadığında çağrılır.

- (geçersiz) getRouteInfoForDestination:	(GMSNavigationWaypoint *)	hedef
withRoutingOptions:	(GMSNavigationRoutingOptions *)	routingOptions
geri arama:	(GMSRouteInfoCallback)	geri arama

Rota stratejisine (varsayılan en iyi veya daha kısa rota) bağlı olarak rota bilgilerini döndürür.

Bu yöntem yalnızca Google tarafından işlem başına faturalandırılan Mobilite Hizmetleri müşterileri tarafından kullanılabilir. Projenin bu API'yi çağırma izni yoksa "nil" değerini döndürür.

Parametreler:

hedef	Varış noktası ara 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 geri çağırma yapıldı.

- (nullable GMSNavigationWaypoint *) continueToNextDestination

Kullanımdan kaldırıldı.

Bunun yerine, yeni hedef listesiyle -setDestinations:... yöntemlerinden birini çağırın.

Geçerli hedef listesindeki ilk hedefi görüntüler. Bu aramadan sonra, varsa bir sonraki hedefe yönelik rehberlik sağlanacaktır.

Şunu döndürür:: ara nokta rehberliği artık doğru ilerliyor veya başka ara nokta kalmadıysa hiç yok.

Not:: Bu kullanımdan kaldırıldı. Bunun yerine, -setDestinations:... yöntemlerinden birini kullanın.

- (geçersiz) clearDestinations

Önceden ayarlanmış tüm hedefleri temizler ve hesaplanan rotaları haritadan kaldırır.

Kılavuzluk etkinse otomatik olarak durdurulur.

- (NSTimeInterval) timeToWaypoint: (GMSNavigationWaypoint *) ara nokta

Verilen ara noktanın tahmini süresini veya ara nokta, geçerli rotanın parçası değilse CLTimeIntervalMax değerini döndürür.

Yönlendirme etkin durumdayken 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.

- (CLLocationMesafe) distanceToWaypoint: (GMSNavigationWaypoint *) ara nokta

Verilen ara noktaya kadar olan tahmini mesafeyi veya ara nokta, geçerli rotanın parçası değilse CLLocationRemoteMax değerini döndürür.

Bu, yönlendirme etkin durumdayken cihazın mevcut konumuna göre güncellenecektir.

Sağlanan ara nokta, geçerli rotadaki bir hedef değilse CLLocationRemoteMax değerini döndürür.

- (geçersiz) setTransactionIDs:	(NSArray< NSString * > *)	transactionIDs
errorHandler:	(boş değer atanabilir GMSNavigationTransactionIDErrorHandler)	errorHandler

Geçerli gezinme oturumu sırasında gezinme etkinlikleri için geçerli olan devam eden işlem kimliklerini ayarlar ve sunucuya günlüğe kaydeder.

İşlem kimlikleri, gezinme oturumunun sonunda temizlenir. Bu yöntem yalnızca Google tarafından işlem başına faturalandırılan Mobilite Hizmetleri müşterileri tarafından kullanılabilir. Projenin bu API'yi çağırma izni yoksa "nil" değerini döndürür.

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. Bireysel işlem kimliği en az bir, en fazla 64 karakterden oluşmalıdır. Bir işlem sona erdiğinde (ancak oturum devam ediyordur) 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)(GMSRouteStatus rotaStatus)) [related]

Cihazın konumundan sağlanan hedeflere bir rota bulunduğunda veya RouteStatus tarafından belirtilen bir nedenden dolayı bulunamadığında çağrılır.

- (typedef void(^ GMSRouteInfoCallback)(GMSNavigationRouteInfo *_Nullable pathInfo)) [related]

Sağlanan ara noktaya ilişkin rota bilgisi (TVS ve mesafe) hesaplandığında çağrılır.

Parametreler:

routeInfo Belirtilen hedefe ilişkin rota bilgileri. Hesaplama başarısız olursa boş değerini alır.

- (typedef void(^ GMSNavigationTransactionIDErrorHandler)(NSError *hata)) [related]

setTransactionIDs aracılığıyla işlem kimliklerinin ayarlanması başarısız olursa çağrılır.

Daha fazla bilgi için API belgelerine bakın.

Mülk Belgeleri

- (BOOL) avoidsHighways [read, write, assign]

Hedeflere giden rota oluşturulurken otoyolların kullanılıp kullanılmayacağını belirler.

Varsayılan olarak HAYIR.

- (BOOL) avoidsTolls [read, write, assign]

Hedeflere giden rota oluştururken paralı yollardan kaçınılıp kaçınılmayacağını belirler.

Varsayılan olarak HAYIR.

- (BOOL) avoidsFerries [read, write, assign]

Hedeflere giden rota oluştururken feribotların kullanılıp kullanılmayacağı.

Varsayılan olarak EVET 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 belirleyin.

Bu şekilde, plaka numarasına göre belirlenen yol kısıtlaması türlerinin etrafından rota izleyebiliyoruz. Bu durum yalnızca bu değer ayarlandıktan sonra yapılan setDestinations çağrıları için geçerlidir. İdeal olarak, bunu navigasyonu başladıktan hemen sonra yapmanız gerekir.

Plaka kısıtlaması yoksa sıfır olarak ayarlayın. Varsayılan olarak nil değerini girin.

- (BOOL) guidanceActive [read, write, assign]

Adım adım rehberliğin şu anda etkin olup olmadığı.

GuideActive EVET değerine ayarlanmasına rağmen şu anda kullanılabilir rota yoksa bir rota kullanılabilir hale geldiğinde rehberlik başlar. clearDestinations çağrılırsa veya bir ara noktaya ulaşırsak bu tesis HAYIR olarak ayarlanır.

- (BOOL) stopGuidanceAtArrival [read, write, assign]

-navigator:didReachAtWaypoint: çağrıldığında yönlendirmenin otomatik olarak durup durmayacağı.

HAYIR durumundaysa, gezinme üstbilgisi ve altbilgisi varıştan sonra gösterilmeye devam eder. Gezinme üstbilgisi son rehberlik adımını göstermeye devam eder ve gezinme altbilgisi, 0 değerine/mesafeye ulaşılana kadar kalan süreyi ve mesafeyi güncellemeye devam eder. Ayrıca, -navigator:didUpdateRemainingTime ve -navigator:didUpdateRemainingLength güncellemeleri devam edecek. Yönlendirmeyi ve kalan süre/mesafe güncellemelerini durdurmak için guidanceActive değerini açıkça HAYIR olarak ayarlayın.

EVET ise guidanceActive, varışta otomatik olarak HAYIR şeklinde ayarlanır.

Varsayılan olarak EVET değerine ayarlanır.

- (NSTimeInterval) timeUpdateThreshold [read, write, assign]

navigator:didUpdateRemainingTime: yönteminin çağrılmasını tetikleyecek bir sonraki hedefe kalan tahmini süredeki minimum değişim.

Bu ayar NSTimeIntervalMax olarak ayarlanırsa zaman güncelleme geri çağırmaları devre dışı bırakılır. Negatif bir değere ayarlanırsa bir saniyelik varsayılan eşik kullanılır. Varsayılan olarak bir saniyedir.

Not:: navigator:didUpdateRemainingTime: hiçbir işleyici uygulamazsa bu değer yoksayılır.

- (CLLocationMesafe) distanceUpdateThreshold [read, write, assign]

navigator:didUpdateRemainingDistance: yönteminin çağrılmasını tetikleyecek bir sonraki hedefe olan tahmini mesafedeki minimum değişim.

Bu ayar CLLocationLengthMax olarak belirlenirse mesafe güncelleme geri çağırmaları devre dışı bırakılır. Politika negatif bir değere ayarlanırsa bir metrelik varsayılan eşik kullanılır. Varsayılan olarak bir metredir.

Not:: navigator:didUpdateRemainingDistance: hiçbir işleyici uygulamazsa bu değer yoksayılır.

- (NSTimeInterval) timeToNextDestination [read, assign]

Sonraki hedefe kalan tahmini süreyi döndürür.

Bu, yönlendirme etkin durumdayken cihazın mevcut konumuna göre güncellenecektir.

Kullanılabilir rota yoksa CLTimeIntervalMax değerini döndürür.

- (CLLocationMesafe) distanceToNextDestination [read, assign]

Bir sonraki hedefe kalan tahmini mesafeyi döndürür.

Bu, yönlendirme etkin durumdayken cihazın mevcut konumuna göre güncellenecektir.

Kullanılabilir rota yoksa CLLocationPositionMax değerini döndürür.

- (GMSNavigationDelayCategory) delayCategoryToNextDestination [read, assign]

Gecikme kategorisini sonraki hedefe döndürür.

Bu, yönlendirme etkin durumdayken cihazın mevcut konumuna göre güncellenecektir.

Rota yoksa veya trafik verileri mevcut değilse GMSAVGecikmeCategoryNoData değerini döndürür.

- (GMSRouteLeg*) currentRouteLeg [read, assign]

Yolculuğun mevcut ayağı.

Bu GMSRouteLeg'in başlangıç konumu, cihazın bilinen en son (yola takılmış) konumu olarak bulunur.

- (NSArray<GMSRouteLeg *>*) routeLegs [read, assign]

Her ayağın belirlenmiş bir hedefe karşılık geldiği rota bacakları dizisi.

- (GMSPath*) traveledPath [read, assign]

Kullanıcının en son rehberlik oturumunda katettiği yol. Araç, en son EVET olarak ayarlandığı zaman olarak tanımlanır.

Yol, GMSRoadSnappedLocationProvider tarafından döndürülen ve çizgi segmentlerinin oluşturulması basitleştirilmiş olan yol tutturulmuş konumlardan oluşur.

Not:: Sistem, konum verilerini almak amacıyla GPS sinyalleri için istemciyi yoklar. GPS sinyalinin zayıf olması, daha fazla interpolasyona neden olarak daha az kesin rotalar üretilmesine neden olabilir. Kılavuz hiç başlamadıysa bu yol boş olur.

- (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 GMSGezinmeVoiceGuidanceAlertsAndGuidance değerine ayarlanır.

- (GMSVoiceGuidanceAudioDeviceType) audioDeviceType [read, write, assign]

Hangi ses cihazlarındaki sesli yardımın oynatılabileceğini belirler.

Varsayılan olarak GMSVoiceGuidanceAudioDeviceTypeBluetooth 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]

Uygulama arka plandayken rehberlik bilgileri içeren UILocalBildirimler'in sunulup sunulmayacağını belirler.

Varsayılan olarak EVET değerine ayarlanır.

- (GMSNavigationLightingMode) suggestedLightingMode [read, assign]

Günün saatine ve cihazın konumuna göre önerilen ışıklandırma modu.

- (BOOL) shouldDisplayPrompts [read, write, assign]

Trafik, daha iyi rotalar ve olaylarla ilgili istemlerin gösterilip gösterilmeyeceğini belirler.

Varsayılan olarak EVET değerine ayarlanır.

- (GMSNavigationSpeedAlertOptions*) speedAlertOptions [read, write, assign]

GMSNavigationSpeedAlertOptions öğesini kullanarak GMSGezinmeSpeedAlertSeverity tetikleme eşiklerini özelleştirmenize olanak tanır.

Bu özelliği, hem küçük hem de önemli uyarılar için hız uyarısı tetikleme eşiklerini yüzde olarak özelleştirmek amacıyla kullanabilirsiniz. Bu yöntemi, önemli hız uyarısı için zamana dayalı tetikleme eşiğini özelleştirmek için de kullanabilirsiniz.

Sıfır değerini ayarladığınızda hızlı feed verileri almazsınız ve NavSDK'nın varsayılan hız uyarısı gösterilir: Hız uyarısı, hız sınırının 8 mil/10 km/sa. üzerinde olduğunda kırmızı metin, 10 mil/sa. ya da 20 km/sa. üzerinde giderken beyaz metin ve kırmızı arka plan gösterir.

GMSNavigator Sınıf Referansı

Genel Bakış

Genel Üye İşlevleri

Tesisler

İlgili İşlevler

Üye İşlevi Belgeleri

Arkadaşlar ve İlgili İşlev Dokümanları

Mülk Belgeleri