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.
Arkadaşlar ve İlgili İşlev Dokümanları
- (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.